![tradable-bits-long-logo-for-download.png]](https://resources.tradablebits.com/hs-fs/hubfs/tradable-bits-long-logo-for-download.png?height=40&name=tradable-bits-long-logo-for-download.png){kind=logo}
Getting Started with Outgoing Webhooks
This guide explains how to set up, secure, and handle Outgoing Webhooks to receive real-time notifications whenever events occur in Tradable Bits (e.g., fan updates, user activity, or loyalty point awards).
What is an Outgoing Webhook?
Tradable Bits outgoing webhooks deliver real-time data directly to your server via HTTP POST requests containing JSON payloads.
- Trigger-Based: Webhooks fire automatically whenever a fan record is updated, an activity takes place, or points are awarded.
- Asynchronous Delivery: Webhook delivery is asynchronous. While events are processed rapidly in Tradable Bits, HTTP notifications may take a few seconds from the moment an action occurs to reach your endpoint.
Prerequisites: An active HTTP endpoint URL (this can be a custom backend server, or a receiving URL generated by a platform like Shopify, Zapier, Make, or your CRM)
Setup
1. Generate Your Signing Key
Every webhook request sent by Tradable Bits includes an HTTP header: X-Tbits-Api-Signature. This value is a base64-encoded HMAC-SHA256 signature generated using your secret signing key
In the Webhook Verification section at the top of the page, click the Generate button.
Important: The key is a 32-byte secret encoded as base64. It is displayed only once upon creation. Copy and store it securely in your server's secret manager or environment variables.
2. Configure Your Webhook Endpoints
When events occur, Tradable Bits sends an HTTP POST request containing a JSON body with Content-Type: application/json.
Scroll down to the Fan/Activity Webhooks section and enter your public HTTPS endpoint URLs:
- Fan Webhook URL: Enter your receiver URL to listen for profile additions or updates. Toggle Fan Webhook Status to active.
- Activity Webhook URL: Enter your receiver URL to listen for campaign entries and actions. Toggle Activity Webhook Status to active. Check Include Details if your integration requires expanded context for user interactions.
- Fan Point Webhook URL: Enter your receiver URL to listen for earned points, badges, or reward events. Toggle Fan Points Webhook Status to active.
Click Save at the bottom right of the page to apply your settings.
⚠️ Important
Webhook notifications are delivered in real time as single events. In the event of a service disruption (whether on the Tradable Bits platform or your receiving server), undelivered data will not be automatically re-sent. Webhooks attempt delivery only once.