# Webhook Subscriptions

## Adding Webhook Subscriptions

Once you've created your connection, you need to subscribe to events in TilliT.

In you newly created channel, go to the Subscriptions tab and click ***Actions > Create***. You will be presented with a pop-up.

<figure><img src="/files/jW8fRSmIAJ4K7SzjYDpH" alt=""><figcaption></figcaption></figure>

| Name                | Description                                                                                                                                                                                                                                                                                                                                                                                              |
| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Event Type          | <p>Event trigger you want to use.<br>If you only select an event type, you will receive payloads every time that event triggers. Using the other fields allows you to make more specific subscriptions.</p>                                                                                                                                                                                              |
| Asset               | A specific asset you want                                                                                                                                                                                                                                                                                                                                                                                |
| Order               | A specific order number you want                                                                                                                                                                                                                                                                                                                                                                         |
| Activity Key        | One Activity Key of your Activity Template.                                                                                                                                                                                                                                                                                                                                                              |
| Channel             | The channel you are subscribing to. If you are using [User Channels](/tillit/knowledge-base/users/manage/user-channels.md), find your username.                                                                                                                                                                                                                                                          |
| Site                | A specific site you want                                                                                                                                                                                                                                                                                                                                                                                 |
| Asset Class         | A specific asset class you want. It will filter for all assets under that class.                                                                                                                                                                                                                                                                                                                         |
| Parent Asset        | It will filter for all assets that have this parent asset.                                                                                                                                                                                                                                                                                                                                               |
| Activities Included | <p>This only applies for user email subscriptions. See <a data-mention href="/pages/DF655nnc7N6yqXRNrrVq">/pages/DF655nnc7N6yqXRNrrVq</a>. You must choose a channel that you created for your user profile if you want this option.<br>If you are sending an email, TilliT will include the results of any activity result you have in the email. Maintain a list of comma-separated activity keys.</p> |

In the example shown, we have set the subscription to send a payload on ***Activity completed***, but only for the Activity with the key KWTesting.

<figure><img src="https://d33v4339jhl8k0.cloudfront.net/docs/assets/60208fd212248b2c96d50eeb/images/62abe235f6341f7edc2a5ef4/file-s3Z38fMGjM.png" alt=""><figcaption></figcaption></figure>

Now, whenever that activity successfully completes, the Webhook will send it's payload to our other service.

All notification webhooks sent from TilliT have a retry strategy. To identify which retry attempt the webhook you receive is, we have attached a header `X-Retry-Count`.

<figure><img src="https://d33v4339jhl8k0.cloudfront.net/docs/assets/60208fd212248b2c96d50eeb/images/62abde9e06aa975578463277/file-jKYJq8ML35.png" alt=""><figcaption></figcaption></figure>

<figure><img src="https://d33v4339jhl8k0.cloudfront.net/docs/assets/60208fd212248b2c96d50eeb/images/62abe1091e5b41737b38ed3c/file-ddmvrxajTI.png" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.tillit.cloud/tillit/knowledge-base/setting-up-tillit/integrations/adding-webhook-subscriptions.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
