API

The API section is where you connect Fanhaven to your own systems. Open it from Settings → API. It has three tabs:

API reference

Full endpoint docs: authentication, fans, transactions, events, merch, and webhooks.

API keys authenticate server-to-server requests to https://api.fanhaven.com/v1.

Scope	Access
`fans:read`	List and retrieve fans
`transactions:read`	List and retrieve sales
`events:read`	List and retrieve tour dates
`merch:read`	List and retrieve catalog items

Keys are bound to the current artist and tour. Send them as:

Authorization: Bearer fh_live_...

Revoked keys cannot be restored. Update external systems with a new key before revoking the old one.

Webhooks send HTTP POSTs to your URL when events happen in Fanhaven. See Webhooks for payload shape and signature verification.

Integration	How to build it
CRM sync	`GET /v1/fans` to pull audience data
Custom analytics	`GET /v1/transactions` or a transaction webhook
Warehouse / catalog	`GET /v1/merch`
Show calendar	`GET /v1/events`