Subscription Generated

5 min

Fired when any subscription is created after an order is completed, regardless of type. This includes regular, prepaid, gifted, and converted-from-prepaid subscriptions. For regular subscriptions, this event fires in addition to Subscription Created.

Properties

Name	Type	Description	Required
subscription_id	string	Unique ID of the subscription	Yes
interval_length	number	Combined with interval_units, specifies the cadence of the subscription. E.g. for a 3 week cadence, this value will be 3.	No
interval_units	string	Combined with interval_length, specifies the cadence of the subscription. E.g. for a 3 week cadence, this value will be weeks.	No
actionable_date	string	ISO date when the next installment order will be generated.	No
state	string	State of the subscription (e.g. active, paused, canceled).	No
payment_method_name	string	Name of the payment method for installment orders.	No
email	string	Email address associated with the subscription	No
canceled_at	string	ISO date when the subscription was canceled, if applicable	No
canceled_by	string	Email address of the user who canceled the subscription, if applicable	No
activated_at	string	ISO date when the subscription was activated	Yes
address	object	Shipping address of the subscription.	Yes
products	object[]	Products in the subscription	Yes

Address

Name	Type	Description	Required
address1	string	The street address of the customer	No
address2	string	Additional street address of the customer (if necessary)	No
alternative_phone	string	Customer's alternative phone number	No
phone	string	Customer's phone number	No
city	string	City of the shipping address	No
company	string	Name of the company, if applicable	No
country	string	ISO country code for the shipping address	No
name		Customer name	No
state	string	ISO state code for the shipping address	No
zipcode	string	Zip or postal code for the shipping address	No

Products array

Name	Type	Description	Required
affiliation	string	Store or affiliation from which this transaction occurred (for example, "Google Store").	No
brand	string	Brand associated with the product	No
line_item_id	string	ID of the line item in the database	No
name	string	Name of the product	Yes
position	number	Position in the product list	No
price	number	Price of the product	Yes
product_id	string	ID of the product in the database	Yes
quantity	number	The quantity of products purchased in this line item	Yes
revenue	number	Revenue ($) associated with this line item (excluding shipping and tax)	Yes
sku	string	SKU of the variant	Yes
variant_name	string	Name of the variant	No
variant_id	string	ID of the variant in the database	No

Sample Payload

{
  "type": "track",
  "event": "Subscription Created",
  "properties": {
    "subscription_id": "1",
    "interval_length": 3,
    "interval_units": "weeks",
    "actionable_date": "2026-01-01T00:00:00.000Z",
    "state": "active",
    "payment_method_name": "Stripe",
    "email": "[email protected]",
    "canceled_at": null,
    "canceled_by": null,
    "activated_at": "2026-01-01T00:00:00.000Z",
    "address": {
      "address1": "123 Fake St",
      "address2": null,
      "alternative_phone": null,
      "phone": "123456789",
      "city": "Oak Lawn",
      "state": "IL",
      "country": "US",
      "name": "John Doe",
      "zipcode": "60532"
    },
    "products": [
      {
        "affiliation": "Affiliation",
        "brand": "Brand",
        "line_item_id": "16207084552295",
        "name": "Product Name",
        "position": 1,
        "price": 219,
        "product_id": "7036464939671",
        "quantity": 1,
        "revenue": 219,
        "sku": "SKU123",
        "variant": "Variant Name",
        "variant_id": "40952658057847"
      }
    ]
  }
}

Example

curl https://production.cdp.ingest.chord.co/api/track \
--header "Content-Type: application/json" \
--header "X-Write-Key: $CDP_WRITE_KEY" \
--data-raw '
{
  "type": "track",
  "event": "Subscription Created",
  "properties": {
    "subscription_id": "1",
    "interval_length": 3,
    "interval_units": "weeks",
    "actionable_date": "2026-01-01T00:00:00.000Z",
    "state": "active",
    "payment_method_name": "Stripe",
    "email": "[email protected]",
    "canceled_at": null,
    "canceled_by": null,
    "activated_at": "2026-01-01T00:00:00.000Z",
    "address": {
      "address1": "123 Fake St",
      "address2": null,
      "alternative_phone": null,
      "phone": "123456789",
      "city": "Oak Lawn",
      "state": "IL",
      "country": "US",
      "name": "John Doe",
      "zipcode": "60532"
    },
    "products": [
      {
        "affiliation": "Affiliation",
        "brand": "Brand",
        "line_item_id": "16207084552295",
        "name": "Product Name",
        "position": 1,
        "price": 219,
        "product_id": "7036464939671",
        "quantity": 1,
        "revenue": 219,
        "sku": "SKU123",
        "variant": "Variant Name",
        "variant_id": "40952658057847"
      }
    ]
  }
}
'