# Webhooks

Webhooks for system event notifications.

**Setup:**

1. Go to Creator Dashboard → Settings (three-dot menu) → API Keys section
2. Generate API key if you haven't already
3. Specify your webhook URL in the webhook settings

**Signature verification:** Each request contains `trbt-signature` header with HMAC-SHA256 signature of request body signed with your API key.

**Retry attempts:** On delivery failure, system retries after 5min, 15min, 30min, 1h, 10h.

**Subscription type (payload.type) in subscription events:**

* `regular` — regular paid subscription (new subscription or renewal)
* `gift` — gift subscription (gift purchase)
* `trial` — trial subscription (trial activation)

**Type transitions:** When a `gift` or `trial` subscription renews, the next subscription becomes `regular`, reflected in the `renewed_subscription` event.

{% openapi-webhook spec="api-en" name="newSubscription" method="post" %}
[Broken link](https://wiki.tribute.tg/for-content-creators/api-documentation/broken-reference)
{% endopenapi-webhook %}

{% openapi-webhook spec="api-en" name="cancelledSubscription" method="post" %}
[Broken link](https://wiki.tribute.tg/for-content-creators/api-documentation/broken-reference)
{% endopenapi-webhook %}

{% openapi-webhook spec="api-en" name="renewedSubscription" method="post" %}
[Broken link](https://wiki.tribute.tg/for-content-creators/api-documentation/broken-reference)
{% endopenapi-webhook %}

{% openapi-webhook spec="api-en" name="physicalOrderCreated" method="post" %}
[Broken link](https://wiki.tribute.tg/for-content-creators/api-documentation/broken-reference)
{% endopenapi-webhook %}

{% openapi-webhook spec="api-en" name="physicalOrderShipped" method="post" %}
[Broken link](https://wiki.tribute.tg/for-content-creators/api-documentation/broken-reference)
{% endopenapi-webhook %}

{% openapi-webhook spec="api-en" name="physicalOrderCanceled" method="post" %}
[Broken link](https://wiki.tribute.tg/for-content-creators/api-documentation/broken-reference)
{% endopenapi-webhook %}

{% openapi-webhook spec="api-en" name="newDonation" method="post" %}
[Broken link](https://wiki.tribute.tg/for-content-creators/api-documentation/broken-reference)
{% endopenapi-webhook %}

{% openapi-webhook spec="api-en" name="recurrentDonation" method="post" %}
[Broken link](https://wiki.tribute.tg/for-content-creators/api-documentation/broken-reference)
{% endopenapi-webhook %}

{% openapi-webhook spec="api-en" name="cancelledDonation" method="post" %}
[Broken link](https://wiki.tribute.tg/for-content-creators/api-documentation/broken-reference)
{% endopenapi-webhook %}

{% openapi-webhook spec="api-en" name="newDigitalProduct" method="post" %}
[Broken link](https://wiki.tribute.tg/for-content-creators/api-documentation/broken-reference)
{% endopenapi-webhook %}

{% openapi-webhook spec="api-en" name="digitalProductRefund" method="post" %}
[Broken link](https://wiki.tribute.tg/for-content-creators/api-documentation/broken-reference)
{% endopenapi-webhook %}