> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cope.com/llms.txt
> Use this file to discover all available pages before exploring further.

# cart.product.created

> A product has been created.

# cart.product.created

> Generated from COPE public event contracts. Do not edit this page by hand.

Use this event to mirror a new product into your own catalog as soon as it is created. A product is created in `review` and is not sellable until it is approved — track cart.product.approval\_status.changed for that. `is_first_product` is present only on the very first product a creator publishes.

## Delivery Contract

| Field           | Value                                                                                |
| --------------- | ------------------------------------------------------------------------------------ |
| Encoding        | CloudEvents 1.0 structured JSON                                                      |
| Delivery        | At least once                                                                        |
| Idempotency     | Use the CloudEvents `source` + `id` tuple, or COPE `idempotency_key` when available. |
| Source          | `cope.cart`                                                                          |
| Subject pattern | `product:<identifier>`                                                               |
| Category        | Products                                                                             |
| Availability    | Available in the public webhook reference.                                           |
| Schema title    | cart.product.created v1 payload                                                      |
| Schema ID       | `https://schemas.cope.com/events/cart.product.created/v1`                            |

## Payload Fields

| Field              | Required | Type      | Allowed Values         | Description                                                                                                                                                                                                                                                                                                                      |                                                             |
| ------------------ | -------- | --------- | ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------- |
| `actor_user_id`    | yes      | \`string  | null\`                 | -                                                                                                                                                                                                                                                                                                                                | SSO ID for the user who created the product when available. |
| `event_id`         | yes      | `string`  | -                      | -                                                                                                                                                                                                                                                                                                                                |                                                             |
| `event_type`       | yes      | `const`   | `cart.product.created` | -                                                                                                                                                                                                                                                                                                                                |                                                             |
| `is_first_product` | no       | `unknown` | -                      | Always `true` when present, and present only on the first Product created for the business; omitted for every later product. The event fired for the first product alone when this was a required property; it now fires for every product, so achievement and milestone consumers MUST gate on the flag being present and true. |                                                             |
| `occurred_at`      | yes      | `string`  | -                      | -                                                                                                                                                                                                                                                                                                                                |                                                             |
| `product_id`       | yes      | `integer` | -                      | Numeric product identifier retained for older consumers. Reference the product by `product_uuid`.                                                                                                                                                                                                                                |                                                             |
| `product_name`     | yes      | \`string  | null\`                 | -                                                                                                                                                                                                                                                                                                                                | -                                                           |
| `product_type`     | yes      | \`string  | null\`                 | -                                                                                                                                                                                                                                                                                                                                | -                                                           |
| `schema_version`   | yes      | `const`   | `1.0`                  | -                                                                                                                                                                                                                                                                                                                                |                                                             |

## Example CloudEvent

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "data": {
    "actor_user_id": "example_id",
    "event_id": "example_id",
    "event_type": "cart.product.created",
    "occurred_at": "2026-05-05T12:00:00.000Z",
    "product_id": 1000,
    "product_name": "example_product_name",
    "product_type": "example_product_type",
    "schema_version": "1.0"
  },
  "datacontenttype": "application/json",
  "dataschema": "https://schemas.cope.com/events/cart.product.created/v1",
  "id": "cart.product.created:example",
  "idempotency_key": "cart.product.created:example",
  "source": "cope.cart",
  "specversion": "1.0",
  "subject": "product:example",
  "time": "2026-05-05T12:00:00.000Z",
  "type": "cart.product.created"
}
```

## Compatibility

Fields may be added within the same major version. Removing or changing the meaning of a documented field requires a new event version.