customer.subscription.created

{
  "id": "evt_1a2b3c4d5e6f7g8h",
  "type": "customer.subscription.created",
  "created_at": "2026-04-27T12:00:00.000000+00:00",
  "organization_id": "acct_7KpQ2mNv4XbR9dLc",
  "data": {
    "subscription_id": "sub_1a2b3c4d5e",
    "customer": {
      "customer_id": "cust_1a2b3c4d5e6f",
      "email": "jane@example.com",
      "name": "Jane Doe",
      "phone_number": "+2348012345678",
      "metadata": {},
      "billing_address": {
        "line1": "40 Yaba Road",
        "line2": null,
        "city": "Lagos",
        "state": "Lagos",
        "postal_code": "101245",
        "country": "NG"
      },
      "created_at": "2026-03-01T12:00:00Z",
      "updated_at": "2026-03-01T12:00:00Z"
    },
    "product_id": "prod_abc123",
    "status": "active",
    "collection_method": "charge_automatically",
    "currency": "USD",
    "amount": "10.00",
    "billing_cycle": { "interval": "month", "frequency": 1 },
    "quantity": 1,
    "current_period_start": "2026-04-01T00:00:00Z",
    "current_period_end": "2026-05-01T00:00:00Z",
    "next_billed_at": "2026-05-01T00:00:00Z",
    "trial_end": null,
    "cancel_at_period_end": false,
    "canceled_at": null,
    "created_at": "2026-03-01T12:00:00Z",
    "items": [],
    "metadata": {}
  }
}

{
  "id": "evt_1a2b3c4d5e6f7g8h",
  "type": "customer.subscription.created",
  "created_at": "2026-04-27T12:00:00.000000+00:00",
  "organization_id": "acct_7KpQ2mNv4XbR9dLc",
  "data": {
    "subscription_id": "sub_1a2b3c4d5e",
    "customer": {
      "customer_id": "cust_1a2b3c4d5e6f",
      "email": "jane@example.com",
      "name": "Jane Doe",
      "phone_number": "+2348012345678",
      "metadata": {},
      "billing_address": {
        "line1": "40 Yaba Road",
        "line2": null,
        "city": "Lagos",
        "state": "Lagos",
        "postal_code": "101245",
        "country": "NG"
      },
      "created_at": "2026-03-01T12:00:00Z",
      "updated_at": "2026-03-01T12:00:00Z"
    },
    "product_id": "prod_abc123",
    "status": "active",
    "collection_method": "charge_automatically",
    "currency": "USD",
    "amount": "10.00",
    "billing_cycle": { "interval": "month", "frequency": 1 },
    "quantity": 1,
    "current_period_start": "2026-04-01T00:00:00Z",
    "current_period_end": "2026-05-01T00:00:00Z",
    "next_billed_at": "2026-05-01T00:00:00Z",
    "trial_end": null,
    "cancel_at_period_end": false,
    "canceled_at": null,
    "created_at": "2026-03-01T12:00:00Z",
    "items": [],
    "metadata": {}
  }
}

Sent when a new subscription is created. Use it to provision access to the recurring product.

{
  "id": "evt_1a2b3c4d5e6f7g8h",
  "type": "customer.subscription.created",
  "created_at": "2026-04-27T12:00:00.000000+00:00",
  "organization_id": "acct_7KpQ2mNv4XbR9dLc",
  "data": {
    "subscription_id": "sub_1a2b3c4d5e",
    "customer": {
      "customer_id": "cust_1a2b3c4d5e6f",
      "email": "jane@example.com",
      "name": "Jane Doe",
      "phone_number": "+2348012345678",
      "metadata": {},
      "billing_address": {
        "line1": "40 Yaba Road",
        "line2": null,
        "city": "Lagos",
        "state": "Lagos",
        "postal_code": "101245",
        "country": "NG"
      },
      "created_at": "2026-03-01T12:00:00Z",
      "updated_at": "2026-03-01T12:00:00Z"
    },
    "product_id": "prod_abc123",
    "status": "active",
    "collection_method": "charge_automatically",
    "currency": "USD",
    "amount": "10.00",
    "billing_cycle": { "interval": "month", "frequency": 1 },
    "quantity": 1,
    "current_period_start": "2026-04-01T00:00:00Z",
    "current_period_end": "2026-05-01T00:00:00Z",
    "next_billed_at": "2026-05-01T00:00:00Z",
    "trial_end": null,
    "cancel_at_period_end": false,
    "canceled_at": null,
    "created_at": "2026-03-01T12:00:00Z",
    "items": [],
    "metadata": {}
  }
}

Event fields

string

The event’s unique identifier, prefixed evt_. Use it to deduplicate deliveries.

string

Always customer.subscription.created.

string

When the event occurred, in UTC.

string

Your account’s ID.

string

The subscription’s ID.

object

The full customer object: customer_id, email, name, phone_number, metadata, billing_address, created_at, and updated_at.

string

The product the subscription bills.

string

Subscription status: trialing, active, past_due, unpaid, canceled, or paused.

string

How renewals are collected, e.g. charge_automatically.

string

The billing currency, as an ISO 4217 code.

string

The recurring amount, as a decimal string.

object

The cadence: { interval, frequency }.

string

Start of the current billing period, in UTC.

string

End of the current billing period, in UTC.

string | null

When the subscription next renews, in UTC.

string | null

When the trial ends, or null if not trialing.

boolean

Whether the subscription is set to end at the period end.

string | null

When the subscription was canceled, or null.

object[]

The line items being billed.

object

Your own key-value data on the subscription.

Concepts

Events

Endpoint API

customer.subscription.created

Event fields

​Event fields

Event fields