subscription.created
subscription.created is sent when a subscription started: a paid widget order had a line with mode: subscription, and a subscription with status active was created for it. One event per subscription line of the order; order_id is the same in each. The event is sent at the same moment as that order’s order.paid; the delivery order between the two is not guaranteed.
It is not a checkout event: until the shopper pays there is no subscription, only a pending_payment order with order.created. A renewal does not repeat it — that is subscription.renewed.
Event fields
Section titled “Event fields”| Field | Type | Description |
|---|---|---|
order_id |
string | UUID of the paid widget order the subscription started from; the same id as in order.paid |
The rest of data is the subscription snapshot.
Example
Section titled “Example”{ "id": "019a0b7c-1f3e-7c1a-9c6e-0b9b1c2d3e51", "event": "subscription.created", "created_at": "2026-10-04T09:12:30+00:00", "shop_id": "7f3c2b1a-0d9e-4f8a-b7c6-d5e4f3a2b1c0", "data": { "id": "0199a1b3-5e6f-7a8b-9c0d-1e2f3a4b5c6d", "status": "active", "status_reason": null, "cancellation_reason": null, "product": { "id": "0199a1a0-2c3d-7e4f-8a5b-6c7d8e9f0a1b", "external_id": "SKU-1", "title": "Brit Care Adult Large Breed", "variant": "12 кг" }, "quantity": 1, "price": 249000, "discount_percent": 7, "interval_value": 4, "interval_unit": "week", "next_charge_at": "2026-11-01T09:00:00+00:00", "paused_until": null, "customer": { "id": "0199a1b5-1b2c-7d3e-8f4a-5b6c7d8e9f00", "first_name": "Олена", "last_name": "Коваль", "phone": "+380671234567", "locale": "uk" }, "delivery": { "provider": "nova-poshta", "type": "branch", "data": { "city": { "id": "…", "external_id": "8d5a980d-391c-11dd-90d9-001a92567626", "name": "Київ" }, "branch": { "id": "…", "external_id": "1ec09d88-e1c2-11e3-8c4a-0050568002cf", "name": "Відділення №1: вул. Пирогівський шлях, 135" } }, "recipient": { "first_name": "Олена", "last_name": "Коваль", "phone": "+380671234567" } }, "card": { "brand": "visa", "mask": "**** 4242" }, "created_at": "2026-10-04T09:12:30+00:00", "order_id": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b" }}What to do
Section titled “What to do”- Create the subscription in your system under
data.id— this UUID comes in every latersubscription.*event. - Take the customer and the delivery address from the snapshot (
customer,delivery): no extra request is needed. - Do not book a sale from this event: the money and the order lines are in
order.paid, match them byorder_id. - Remember
next_charge_at: it is the date of the first renewal.
Related events
Section titled “Related events”order.paid— the paid order the subscription started fromsubscription.renewed— the following charges of this subscriptionsubscription.paused— a pause, by hand or by Neocarts
Request headers, signature and retries are in the overview; the order of events is in the event flow.