1. Enable Webhooks
In an artist account, go to Settings > Artist settings and click on the API Keys & Webhooks tab.
Select which event(s) you would like to track and enter your webhook URL to begin listening.
Your webhooks can be disabled, and checked for the last delivery date and any errors that occur during delivery.
2. Authentication (Optional)
Every request includes an X-Openstage-Signature header. To verify the request:
Calculate the HMAC-SHA256 hash of the raw request body using your shared secret, presented to you when you create the webhook.
Convert the hash to a hex string.
Compare it to the header value.
3. Payload Structure
All webhooks arrive as a JSON POST with the following envelope:
{
"event": "event.name",
"timestamp": 1716912000000,
"data": { ... }
}
4. Event Types
Event | Trigger | Data Fields |
fan.created_updated | New fan or change to core fan details | email, firstName, lastName, phoneNumber, location, updatedAt, isNewFan |
fan.activity | Fan actions (login, click, etc.) | metric, resource, createdAt |
5. Retries
Openstage retries on 5xx (server error) and 429 (rate limit) responses.
4xx errors (e.g., 404, 403) are treated as permanent failures and will not be retried.