subscription.activated
Triggered when a subscription starts and its entitlements are live.
X-Clocknext-Signature*stringt=<unix seconds>,v1=<hex HMAC-SHA256> — the HMAC of ${t}.${rawBody} keyed with the endpoint's signing secret. See Verify the signature.
X-Clocknext-Event-Id*stringThe event's id — the same as id in the body, and the same on every retry.
X-Clocknext-Event-Type*stringThe event name — the same as event_type in the body.
application/json- body
id*stringevt_ + 32 hex characters. Unique per event, and the same on every retry of it — use it to skip duplicates.
event_type*stringAlways subscription.activated.
triggered_at*stringWhen the event was triggered (ISO 8601).
date-timedata*The customer and the subscription, as it is after the change.
Answer any 2xx within 5 seconds; the body is ignored. Anything else counts as failed and is retried.
{ "id": "evt_4ce1578e2ab4a20169e731669ac98685", "event_type": "subscription.activated", "triggered_at": "2026-10-01T08:15:26.077Z", "data": { "customer": { "id": "cus_abc123", "name": "Acme Corp" }, "subscription": { "id": "pur_ghi789", "number": "SUB-0004", "status": "ACTIVE", "plan": { "id": "plan_growth", "name": "Growth" }, "billing_cycle": "MONTHLY", "starts_at": "2026-10-01T00:00:00.000Z", "current_period_start": "2026-10-01T00:00:00.000Z", "current_period_end": "2026-11-01T00:00:00.000Z", "next_renewal_date": "2026-11-01T00:00:00.000Z", "hold_ends_at": null, "cancel_requested_at": null, "ends_at": null, "cancel_reason": null } }}{ "X-Clocknext-Signature": "t=1791367200,v1=5257a869e7ecebeda32affa62cdca3fa51cad7e77a0e56ff536d0ce8e108d8bd", "X-Clocknext-Event-Id": "evt_4ce1578e2ab4a20169e731669ac98685", "X-Clocknext-Event-Type": "subscription.activated"}Types
Every object type on this page, with its fields.
SubscriptionActivatedEvent
| Field | Type | Required | Description |
|---|---|---|---|
id | string | yes | evt_ + 32 hex characters. Unique per event, and the same on every retry of it — use it to skip duplicates. |
event_type | string | yes | Always subscription.activated. |
triggered_at | string | yes | When the event was triggered (ISO 8601). |
data | SubscriptionEventData | yes | The customer and the subscription, as it is after the change. |
SubscriptionEventData
The data object of every subscription event except subscription.cancelled: the customer and the subscription, as it is after the change.
| Field | Type | Required | Description |
|---|---|---|---|
customer | WebhookCustomer | yes | The customer the event is about. |
subscription | WebhookSubscription | yes | The subscription when the event is triggered. |
WebhookCustomer
The customer the event is about.
| Field | Type | Required | Description |
|---|---|---|---|
id | string | yes | The customer's Clocknext id. |
name | string | yes | The customer's name. |
WebhookSubscription
The subscription when the event is triggered, as Get a subscription returns its current period.
| Field | Type | Required | Description |
|---|---|---|---|
id | string | yes | The subscription's id — its purchaseId in the Subscriptions API. |
number | string | null | yes | The subscription's number. |
status | "SCHEDULED" | "ACTIVE" | "MARKED_FOR_CANCELLATION" | "CANCELLED" | yes | SCHEDULED, ACTIVE (also on hold, see hold_ends_at), MARKED_FOR_CANCELLATION or CANCELLED. |
plan | object | yes | The plan the subscription is for. |
billing_cycle | "MONTHLY" | "QUARTERLY" | "SEMI_ANNUAL" | "YEARLY" | "FREE" | yes | How often the subscription renews. |
starts_at | string | null | yes | When the current period started; the planned start date while SCHEDULED. |
current_period_start | string | null | yes | The start of the running period. Null when it isn't running (SCHEDULED, CANCELLED). |
current_period_end | string | null | yes | The end of the running period. Null when it isn't running (SCHEDULED, CANCELLED). |
next_renewal_date | string | null | yes | When it renews next. Null when it won't renew. |
hold_ends_at | string | null | yes | The deadline to pay a held renewal or a first invoice; unpaid, the subscription is cancelled. Else null. |
cancel_requested_at | string | null | yes | When it was marked for cancellation. Null when it wasn't. |
ends_at | string | null | yes | When a MARKED_FOR_CANCELLATION subscription ends. Null otherwise. |
cancel_reason | string | null | yes | The text typed when it was cancelled. Null when none was given. |
WebhookSubscription.plan
The plan the subscription is for.
| Field | Type | Required | Description |
|---|---|---|---|
id | string | null | yes | The plan's id. |
name | string | yes | The plan's name. |