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.

New Subscription

Notification about user purchasing a subscription

Payload
namestring · enumRequiredExample: new_subscriptionPossible values:
created_atstring · date-timeRequired

Event creation time

Example: 2025-03-20T01:15:58.33246Z
sent_atstring · date-timeRequired

Event sending time

Example: 2025-03-20T01:15:58.542279448Z
Responses
200
Webhook successfully processed
application/json

Payload

{
  "name": "new_subscription",
  "created_at": "2025-03-20T01:15:58.33246Z",
  "sent_at": "2025-03-20T01:15:58.542279448Z",
  "payload": {
    "subscription_name": "Support creativity 🌟",
    "subscription_id": 1644,
    "period_id": 1547,
    "period": "monthly",
    "price": 1000,
    "amount": 700,
    "currency": "eur",
    "user_id": 31326,
    "telegram_user_id": 12321321,
    "channel_id": 614,
    "channel_name": "lbs",
    "expires_at": "2025-04-20T01:15:57.305733Z"
  }
}

Cancelled Subscription

Notification about user cancelling a subscription

Payload
namestring · enumRequiredExample: cancelled_subscriptionPossible values:
created_atstring · date-timeRequired

Event creation time

Example: 2025-03-21T11:20:44.013969Z
sent_atstring · date-timeRequired

Event sending time

Example: 2025-03-21T11:20:44.527657077Z
Responses
200
Webhook successfully processed
application/json

Payload

{
  "name": "cancelled_subscription",
  "created_at": "2025-03-21T11:20:44.013969Z",
  "sent_at": "2025-03-21T11:20:44.527657077Z",
  "payload": {
    "subscription_name": "Join the private club 🎉",
    "subscription_id": 1646,
    "period_id": 1549,
    "period": "monthly",
    "price": 1000,
    "amount": 1000,
    "currency": "eur",
    "user_id": 31326,
    "telegram_user_id": 12321321,
    "channel_id": 614,
    "channel_name": "lbs",
    "cancel_reason": "",
    "expires_at": "2025-03-20T11:13:44.737Z"
  }
}

Physical Order Created

Notification about new physical order creation

Payload
namestring · enumRequiredExample: physical_order_createdPossible values:
created_atstring · date-timeRequired

Event creation time

sent_atstring · date-timeRequired

Event sending time

Responses
200
Webhook successfully processed

Payload

{
  "name": "physical_order_created",
  "created_at": "2025-06-24T16:16:02.584Z",
  "sent_at": "2025-06-24T16:16:02.584Z",
  "payload": {
    "order_id": 12345,
    "status": "pending",
    "user_id": 31326,
    "telegram_user_id": 12321321,
    "products": [
      {
        "product_name": "T-shirt with print",
        "quantity": 2,
        "price": 150000,
        "currency": "USD"
      }
    ],
    "total": 300000,
    "currency": "USD",
    "shipping_address": "USA, New York, 5th Avenue, 123, Apt 45",
    "tracking_number": "US123456789CN",
    "created_at": "2025-03-20T01:15:58.33246Z",
    "updated_at": "2025-03-20T01:15:58.33246Z"
  }
}

Physical Order Shipped

Notification about physical order shipping

Payload
namestring · enumRequiredExample: physical_order_shippedPossible values:
created_atstring · date-timeRequired

Event creation time

sent_atstring · date-timeRequired

Event sending time

Responses
200
Webhook successfully processed

Payload

{
  "name": "physical_order_shipped",
  "created_at": "2025-06-24T16:16:02.584Z",
  "sent_at": "2025-06-24T16:16:02.584Z",
  "payload": {
    "order_id": 12345,
    "status": "pending",
    "user_id": 31326,
    "telegram_user_id": 12321321,
    "products": [
      {
        "product_name": "T-shirt with print",
        "quantity": 2,
        "price": 150000,
        "currency": "USD"
      }
    ],
    "total": 300000,
    "currency": "USD",
    "shipping_address": "USA, New York, 5th Avenue, 123, Apt 45",
    "tracking_number": "US123456789CN",
    "created_at": "2025-03-20T01:15:58.33246Z",
    "updated_at": "2025-03-20T01:15:58.33246Z"
  }
}

Physical Order Canceled

Notification about physical order cancellation

Payload
namestring · enumRequiredExample: physical_order_canceledPossible values:
created_atstring · date-timeRequired

Event creation time

sent_atstring · date-timeRequired

Event sending time

Responses
200
Webhook successfully processed

Payload

{
  "name": "physical_order_canceled",
  "created_at": "2025-06-24T16:16:02.584Z",
  "sent_at": "2025-06-24T16:16:02.584Z",
  "payload": {
    "order_id": 12345,
    "status": "pending",
    "user_id": 31326,
    "telegram_user_id": 12321321,
    "products": [
      {
        "product_name": "T-shirt with print",
        "quantity": 2,
        "price": 150000,
        "currency": "USD"
      }
    ],
    "total": 300000,
    "currency": "USD",
    "shipping_address": "USA, New York, 5th Avenue, 123, Apt 45",
    "tracking_number": "US123456789CN",
    "created_at": "2025-03-20T01:15:58.33246Z",
    "updated_at": "2025-03-20T01:15:58.33246Z"
  }
}
PreviousOrdersNextWallet Pay