> For the complete documentation index, see [llms.txt](https://wiki.tribute.top/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.tribute.top/es/para-creadores-de-contenido/documentacion-de-la-api/webhooks.md).

# 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 with exponential backoff over \~24 hours: 5min, 15min, 30min, 1h, 2h, 4h, 8h, 8h.

**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="en" name="newSubscription" method="post" %}
[en](https://tribute.tg/api/v1/openapi/en)
{% endopenapi-webhook %}

{% openapi-webhook spec="en" name="cancelledSubscription" method="post" %}
[en](https://tribute.tg/api/v1/openapi/en)
{% endopenapi-webhook %}

{% openapi-webhook spec="en" name="renewedSubscription" method="post" %}
[en](https://tribute.tg/api/v1/openapi/en)
{% endopenapi-webhook %}

{% openapi-webhook spec="en" name="physicalOrderCreated" method="post" %}
[en](https://tribute.tg/api/v1/openapi/en)
{% endopenapi-webhook %}

{% openapi-webhook spec="en" name="physicalOrderShipped" method="post" %}
[en](https://tribute.tg/api/v1/openapi/en)
{% endopenapi-webhook %}

{% openapi-webhook spec="en" name="physicalOrderCanceled" method="post" %}
[en](https://tribute.tg/api/v1/openapi/en)
{% endopenapi-webhook %}

{% openapi-webhook spec="en" name="newDonation" method="post" %}
[en](https://tribute.tg/api/v1/openapi/en)
{% endopenapi-webhook %}

{% openapi-webhook spec="en" name="recurrentDonation" method="post" %}
[en](https://tribute.tg/api/v1/openapi/en)
{% endopenapi-webhook %}

{% openapi-webhook spec="en" name="cancelledDonation" method="post" %}
[en](https://tribute.tg/api/v1/openapi/en)
{% endopenapi-webhook %}

{% openapi-webhook spec="en" name="newDigitalProduct" method="post" %}
[en](https://tribute.tg/api/v1/openapi/en)
{% endopenapi-webhook %}

{% openapi-webhook spec="en" name="digitalProductRefund" method="post" %}
[en](https://tribute.tg/api/v1/openapi/en)
{% endopenapi-webhook %}