> For the complete documentation index, see [llms.txt](https://docs.chord.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chord.co/collect-data/tracking-plan/subscription-created.md). # Subscription Created Subscription has been purchased. **Suggested source:** server **Properties** | Name | Type | Description | Required | | -------------------- | ---------- | ----------------------------------------------------------------------------------------------------- | -------- | | **actionable\_date** | `string` |

Next date when this subscription will be actionable (renewed, expired, etc.)

| no | | **address** | `object` |

Shipping address for the subscription

| no | | **brand** | `string` |

Brand associated with the subscription

| no | | **currency** | `string` |

Currency code of the transaction (for example, "USD")
Pattern: ^\[A-Z]{3}$

| no | | **email** | `string` |

Email address associated with the subscription

| no | | **end\_date** | `string` |

Subscription will stop auto-renewing after this date

| no | | **interval\_length** | `integer` |

Interval number at which the subscription renews

| no | | **interval\_units** | `string` |

Interval unit at which the subscription renews (for example, "month")

| no | | **products** | `object[]` |

Products in the subscription

| no | | **state** | `string` |

The state of the subscription (for example, "active")

| no | | **subscription\_id** | `string` |

ID of the subscription

| no | **Example** ```json { "actionable_date": "2024-04-01", "address": { "address1": "123 Elm Street", "address2": "Suite 456", "city": "Springfield", "company": "Acme Corp", "country": "USA", "name": "John Doe", "phone": "555-1234", "state": "IL", "zipcode": "62704" }, "brand": "Green Thumb Nurseries", "currency": "USD", "email": "subscriber@example.com", "end_date": "2025-04-01", "interval_length": 1, "interval_units": "month", "products": [ { "affiliation": "My Plant Store", "brand": "Green Thumb Nurseries", "bundle": false, "category": "Outdoor Plants", "coupon": "SPRING", "description": "A vibrant, easy-to-care-for garden plant perfect for adding a splash of color to any outdoor space.", "image_url": "https://example.com/images/petunia.jpg", "line_item_id": "234567891", "name": "Petunia", "option_values": [ "Purple", "Red", "White" ], "parts": [ { "name": "Purple Petunias", "options_text": "Purple" }, { "name": "Pink Petunias", "options_text": "Pink" } ], "position": 3, "price": 7.99, "product_id": "123456789", "quantity": 2, "sku": "PETUNIA-001", "slug": "petunia", "url": "https://example.com/plants/petunia", "variant": "Purple" } ], "state": "active", "subscription_id": "SUB-123456789" } ``` ## address object Shipping address for the subscription **Properties** | Name | Type | Description | Required | | ------------ | -------- | ---------------------------------- | -------- | | **address1** | `string` |

Street address (line 1)

| | | **address2** | `string` |

Street address (line 2)

| | | **city** | `string` |

City

| | | **company** | `string` |

Company

| | | **country** | `string` |

Country

| | | **name** | `string` |

Name

| | | **phone** | `string` |

Phone number

| | | **state** | `string` |

State

| | | **zipcode** | `string` |

Zipcode

| | **Example** ```json { "address1": "123 Elm Street", "address2": "Suite 456", "city": "Springfield", "company": "Acme Corp", "country": "USA", "name": "John Doe", "phone": "555-1234", "state": "IL", "zipcode": "62704" } ``` ## products\[] array Products in the subscription The product **Item Properties** | Name | Type | Description | Required | | ------------------ | ---------- | -------------------------------------------------------------------------------------------------------------------------------- | -------- | | **affiliation** | `string` |

Product affiliation to designate a supplying company or brick and mortar store location (for example, "Google Store")

| no | | **brand** | `string` |

Brand associated with the product

| no | | **bundle** | `boolean` |

Product belongs to a bundle

| no | | **category** | `string` |

Product category

| no | | **coupon** | `string` |

Coupon code associated with a product (for example, "MAY\_DEALS\_3")

| no | | **description** | `string` |

Short description of the product

| no | | **image\_url** | `string` |

Image URL of the product

| no | | **name** | `string` |

Name of the product

| no | | **option\_values** | `string[]` |

Option values of the product variant

| no | | **position** | `integer` |

Position in the product list (for example, 3)

| no | | **price** | `number` |

Price ($) of the product

| no | | **product\_id** | `string` |

Database ID of the product

| no | | **quantity** | `integer` |

Quantity of the product

| no | | **sku** | `string` |

SKU of the product variant

| no | | **slug** | `string` |

Slug of the product, often used in URLs (for example, "product-red")

| no | | **url** | `string` |

URL of the product page

| no | | **variant** | `string` |

Name of the product variant

| no | | **line\_item\_id** | `string` |

Database ID of the line item

| no | | **parts** | `object[]` |

If the product is an assortment, the assortment parts

| no | **Example** ```json [ { "affiliation": "My Plant Store", "brand": "Green Thumb Nurseries", "bundle": false, "category": "Outdoor Plants", "description": "A vibrant, easy-to-care-for garden plant perfect for adding a splash of color to any outdoor space.", "image_url": "https://example.com/images/petunia.jpg", "name": "Petunia", "option_values": [ "Purple", "Red", "White" ], "position": 3, "price": 7.99, "product_id": "123456789", "sku": "PETUNIA-001", "slug": "petunia", "url": "https://example.com/plants/petunia", "variant": "Purple", "coupon": "SPRING", "line_item_id": "234567891", "quantity": 2 } ] ``` ### products\[].option\_values\[] array Option values of the product variant Option value (for example, "red") **Item Type:** `string`\ **Example** ```json [ "Purple" ] ``` ### products\[].parts\[] array If the product is an assortment, the assortment parts Part **Item Properties** | Name | Type | Description | Required | | ----------------- | -------- | --------------------------------------- | -------- | | **name** | `string` |

Assortment part name

| | | **options\_text** | `string` |

Assortment part options text

| | --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.chord.co/collect-data/tracking-plan/subscription-created.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.