Sign in

v1

latestOpenAPI 3.1.0AGPL-3.0-only2026-07-1773264353.7 KB
webhooks

subscription.created webhook

A new subscription was created

postWebhooksubscription.created

Payload

activated_atstring date-time nullable
billing_day_anchorinteger required
billing_start_datestring date nullable
created_atstring date-time required
currencystring required
customer_aliasstring nullable
customer_idstring MeteroidId required
customer_namestring required
end_datestring date nullable
invoice_memostring nullable
invoice_thresholdstring nullable
mrr_centsinteger required
net_termsinteger required
period'MONTHLY' | 'QUARTERLY' | 'SEMIANNUAL' | 'ANNUAL' required
plan_namestring required
start_datestring date required
status'PENDING_ACTIVATION' | 'PENDING_CHARGE' | 'TRIAL_ACTIVE' | 'ACTIVE' | 'TRIAL_EXPIRED' | 'PAUSED' | 'SUSPENDED' | 'CANCELLED' | 'COMPLETED' | 'SUPERSEDED' | 'ERRORED' required
subscription_idstring MeteroidId required
trial_durationinteger nullable
versioninteger required
idstring MeteroidId required
timestampstring date-time required
type'metric.created' | 'customer.created' | 'subscription.created' | 'invoice.created' | 'invoice.finalized' | 'invoice.paid' | 'invoice.voided' | 'invoice.consolidated' | 'quote.accepted' | 'quote.converted' | 'credit_note.created' | 'credit_note.finalized' | 'credit_note.voided' | 'plan.created' | 'plan.published' | 'plan.archived' | 'product.created' | 'product.updated' | 'product.archived' | 'metric.updated' | 'metric.archived' | 'coupon.created' | 'coupon.updated' | 'coupon.archived' | 'addon.created' | 'addon.updated' | 'addon.archived' required

Example payload

{
  "customer_id": "cus_7n42DGM5Tflk9n8mt7Fhc7",
  "subscription_id": "sub_7n42DGM5Tflk9n8mt7Fhc7",
  "id": "evt_7n42DGM5Tflk9n8mt7Fhc7"
}

Response

Webhook received successfully