# Collections create

> Triggered when a collection is created. Reference for the Shoplazza collections/create webhook: request headers and payload fields.

**Webhook** collections/create

Triggered when a collection is created.

Requires the `collection` [access scope](/docs/app/building-blocks/authentication/access-scopes). Minimum supported version: `202007`.

## Request headers

- `X-Shoplazza-Topic` string

  The event that triggered this delivery, e.g. orders/create

  **Example:** `orders/create`
- `X-Shoplazza-Hmac-Sha256` string

  Base64-encoded HMAC-SHA256 signature of the request body, generated with your app's Client Secret. Use it to verify the request comes from Shoplazza
- `X-Shoplazza-Shop-Domain` string

  The domain of the store that generated the event

  **Example:** `example.myshoplaza.com`
- `X-Shoplazza-Api-Version` string

  The API version used to serialize the payload

  **Example:** `2025-06`
- `X-Shoplazza-Deduplication-ID` string

  Deduplication ID for this delivery. It stays the same across retries of the same event—use it for idempotency

## Request body

**Schema | Example**

- `collection` object

  - `id` string

    Collection ID
  - `title` string

    Collection name
  - `handle` string

    Collection handle (a URL-friendly unique alias)
  - `description` string

    Collection description
  - `MetaKeyword` string

    SEO keyword list
  - `meta_title` string

    SEO title of the collection
  - `meta_description` string

    SEO description of the collection
  - `sort_order` string

    Sorting rule for products in the collection (see the create-collection API for possible values)
  - `url` string

    Storefront collection detail page URL (excluding the store domain)
  - `created_at` string

    Time when the collection was created (ISO-8601 format)
  - `updated_at` string

    Time when the collection was last updated (ISO-8601 format)
  - `image` object

    Collection cover image

    - `src` string

      Image source URL
    - `path` string

      Image path (excluding the domain; `src` includes the domain)
    - `width` integer

      Image width in pixels
    - `height` integer

      Image height in pixels

```json
{
  "collection": {
    "id": "string",
    "title": "string",
    "handle": "string",
    "description": "string",
    "MetaKeyword": "string",
    "meta_title": "string",
    "meta_description": "string",
    "sort_order": "string",
    "url": "string",
    "created_at": "string",
    "updated_at": "string",
    "image": {
      "src": "string",
      "path": "string",
      "width": 0,
      "height": 0
    }
  }
}
```
