Webhook event

`subscription.created`

A subscription was created with its first order.

Type: subscription.created
The object it carries: the subscription object
Subscribe with: subscription.created, subscription.* or *

Example payload

The body of the request your endpoint receives, shown here over several lines. On the wire it is compact JSON; check its signature over the bytes exactly as they arrive.

Example payload

{
  "id": "evt_mm0h0v86fjx03cmj7ekmkfar",
  "object": "event",
  "livemode": true,
  "created": "2026-10-01T08:05:00.000Z",
  "type": "subscription.created",
  "api_version": "2026-10-11",
  "data": {
    "object": {
      "id": "sub_9q5v9rq2naessbxsrec2tsw0",
      "object": "subscription",
      "livemode": true,
      "created": "2026-10-01T08:05:00.000Z",
      "updated": "2026-10-01T08:05:00.000Z",
      "status": "incomplete",
      "customer": "cus_8ea07c40qsvv19f7rgmeb8ha",
      "items": [
        {
          "price": "price_s5n6hhtmyv5erqb81efqgjy6",
          "quantity": 1
        }
      ],
      "amount": "18.00",
      "currency": "USD",
      "interval": "month",
      "interval_count": 1,
      "reminder_days": [
        7,
        3,
        1
      ],
      "grace_days": 3,
      "prepaid_periods_allowed": [
        1,
        3,
        6,
        12
      ],
      "proration": "none",
      "current_period_start": null,
      "current_period_end": null,
      "prepaid_until": null,
      "latest_order": "ord_ayyh1f26ajmj807xjy6ezyfd",
      "renewal": {
        "order": "ord_ayyh1f26ajmj807xjy6ezyfd",
        "checkout_url": "https://pay.orrerie.com/c/cs_7e3kh8bs5dfg9zenk3mkvt28",
        "opens_at": "2026-10-01T08:05:00.000Z",
        "due_at": "2026-10-02T08:05:00.000Z",
        "grace_ends_at": "2026-10-02T08:05:00.000Z"
      },
      "cancel_at_period_end": false,
      "cancelled_at": null,
      "paused_at": null,
      "ended_at": null,
      "cancellation_reason": null,
      "metadata": {}
    }
  },
  "request": {
    "id": "req_c454pdhvpfr55c7br4jvzqep",
    "idempotency_key": "a3f1c2de-7b0e-4a55-9d0c-2f6f1f0b8e11"
  },
  "pending_webhooks": 1
}

Fields of data.object

Fields of data.object in subscription.created
Field	In this example
`id`	`"sub_9q5v9rq2naessbxsrec2tsw0"`
`object`	`"subscription"`
`livemode`	`true`
`created`	`"2026-10-01T08:05:00.000Z"`
`updated`	`"2026-10-01T08:05:00.000Z"`
`status`	`"incomplete"`
`customer`	`"cus_8ea07c40qsvv19f7rgmeb8ha"`
`items`	A list of 1 item
`amount`	`"18.00"`
`currency`	`"USD"`
`interval`	`"month"`
`interval_count`	`1`
`reminder_days`	A list of 3 items
`grace_days`	`3`
`prepaid_periods_allowed`	A list of 4 items
`proration`	`"none"`
`current_period_start`	`null`
`current_period_end`	`null`
`prepaid_until`	`null`
`latest_order`	`"ord_ayyh1f26ajmj807xjy6ezyfd"`
`renewal`	An object with `order`, `checkout_url`, `opens_at`, `due_at`, `grace_ends_at`
`cancel_at_period_end`	`false`
`cancelled_at`	`null`
`paused_at`	`null`
`ended_at`	`null`
`cancellation_reason`	`null`
`metadata`	An object with no fields

What each field means is on the page of the subscription object. This event carries no data.previous_attributes.

Endpoints behind it

Calls that change subscriptions. An event is also sent when a payer, the network, a timer or a person in the dashboard causes the change; the sentence above says which.