> ## 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.cart.created

> A cart has been created.

# cart.cart.created

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

Use this event to start tracking a buyer's cart lifecycle.

## Delivery Contract

| Field | Value |
| - | - |
| Encoding | JSON: `id`, `type`, `version`, `source`, `created_at`, `occurred_at`, `data` |
| Delivery | At least once |
| Idempotency | Deduplicate on `id`: every retry and replay of this event repeats it, and `X-Cope-Event-Id` carries it. |
| Source | `cope.cart` |
| Category | Cart |
| Availability | Available in the public webhook reference. |
| Schema title | cart.cart.created webhook body |
| Schema ID | `https://schemas.cope.com/webhooks/cart.cart.created/v1` |

## Payload Fields

| Field | Required | Type | Allowed Values | Description |
| - | - | - | - | - |
| `attribution` | no | `object` | - | The marketing signals captured when the cart was created: the UTM parameters and ad click ids of the landing URL. Absent when the cart carries none. |
| `business` | no | `object` | - | The business this event concerns. Carries `object` (what it is) and `id` (which one); `id` is the public identifier a merchant addresses it by. |
| `cart` | no | `object` | - | The cart this event concerns. |
| `currency` | yes | `string` | - | - |
| `metadata` | no | `object` | - | - |

## Example delivery

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "created_at": "2026-05-05T12:00:00.000Z",
  "data": {
    "attribution": {
      "fbclid": "example_fbclid",
      "gclid": "example_gclid",
      "msclkid": "example_msclkid",
      "ttclid": "example_ttclid",
      "utm_campaign": "example_utm_campaign",
      "utm_content": "example_utm_content",
      "utm_medium": "example_utm_medium",
      "utm_source": "example_utm_source",
      "utm_term": "example_utm_term"
    },
    "business": {
      "id": "biz_g7-Jq2PxT_4mRvNa",
      "object": "business"
    },
    "cart": {
      "id": "5b1f8c2e-7d4a-4e9b-a3c6-0f2d9e8b7a61",
      "object": "cart"
    },
    "currency": "EUR",
    "metadata": {}
  },
  "id": "8d2f6c1a-4e7b-4a39-b5d0-2c9e1f7a3b64",
  "occurred_at": "2026-05-05T11:59:58.500Z",
  "source": "cope.cart",
  "type": "cart.cart.created",
  "version": "v1"
}
```

## Compatibility

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.