Webhooks
New Subscriber
subscriber.newFires when a fan starts a paid subscription. Includes the price paid and the current billing period.
When it fires
Use this for revenue dashboards, onboarding DMs, or pushing subscriber data into your CRM in real time.
Payload
Wrapped in the standard webhook envelope (event, data, timestamp):
json · example delivery
| 1 | { |
| 2 | "event": "subscriber.new", |
| 3 | "data": { |
| 4 | "subscriber": { |
| 5 | "id": "usr_fan456", |
| 6 | "handle": "fan456", |
| 7 | "displayName": "Sam" |
| 8 | }, |
| 9 | "subscription": { |
| 10 | "id": "sub_abc", |
| 11 | "priceCents": 999, |
| 12 | "currentPeriodStart": "2026-04-28T00:00:00Z", |
| 13 | "currentPeriodEnd": "2026-05-28T00:00:00Z" |
| 14 | } |
| 15 | }, |
| 16 | "timestamp": "2026-04-28T00:00:01Z" |
| 17 | } |
data fields
| Field | Type | Description |
|---|---|---|
subscriber.id | string | ID of the new subscriber. |
subscriber.handle | string | Public handle. |
subscriber.displayName | string | Display name. |
subscription.id | string | ID of the subscription record. |
subscription.priceCents | integer | Subscription price in USD cents. |
subscription.currentPeriodStart | string (ISO 8601) | Start of the current billing period. |
subscription.currentPeriodEnd | string (ISO 8601) | End of the current billing period (renewal date). |