Webhooks

Webhooks push events to your server so you do not have to poll. Manage endpoints from Settings → API → Webhooks.

Setup

{
  "id": "whd_...",
  "type": "fan.created",
  "data": {},
  "created_at": "2026-08-26T12:00:00.000Z"
}

Headers:

Header	Description
`Content-Type`	`application/json`
`X-Fanhaven-Signature`	HMAC-SHA256 hex digest of the raw body
`X-Fanhaven-Delivery`	Delivery ID

Event	Description
`fan.created`	A fan was created
`fan.updated`	A fan record was updated
`transaction.created`	A sale was completed
`transaction.refunded`	A sale was refunded
`order.created`	An inventory order was created
`order.updated`	An inventory order changed status
`event.created`	A tour date was added
`event.updated`	A tour date was updated
`campaign.sent`	A campaign finished sending

Webhook event types are defined for fans, transactions, orders, events, and campaigns. Subscribe to the ones your integration needs.

Return 2xx as soon as you have accepted the payload. Do slower work asynchronously.