> For the complete documentation index, see [llms.txt](https://tads.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tads.gitbook.io/docs/getting-started/publishers/webhooks.md).

# Webhooks

**Webhook URL** is the endpoint on your side that receives a GET or POST request from TADS when a user triggers an event. Optionally, you can add it when [creating a widget.](/docs/getting-started/publishers/create-widget.md)

<div align="left"><figure><img src="https://2317200473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FffNYUJ0jbnLnoGBoTNA7%2Fuploads%2FRu8hhFoildrJMeAdVh2q%2Fimage.png?alt=media&amp;token=0a3f0481-fcd3-4136-8865-edc121ecfa05" alt=""><figcaption></figcaption></figure></div>

The type of event that triggers the webhook is automatically defined by the widget format:

* For **TGB format**, the webhook is triggered **on ad click**.
* For **Fullscreen format**, the webhook is triggered **on ad view**.

Each POST request includes json object with the following data:

* **`telegram_id`** (string) – user Telegram  ID
* **`widget_id`** (string) – ID of the widget where the ad was shown/clicked

{% hint style="info" %}
Please make sure your webhook handler expects **exactly the same parameter names and types** as listed above.
{% endhint %}