# 商品专辑创建

**Webhook** collections/create

商品专辑创建时触发。

需要 `collection` [访问权限](/zh-CN/docs/app/building-blocks/authentication/access-scopes)。最低支持版本：`202007`。

## 请求头

- `X-Shoplazza-Topic` string

  触发本次推送的事件，例如 orders/create

  **示例：** `orders/create`
- `X-Shoplazza-Hmac-Sha256` string

  请求体的 HMAC-SHA256 签名（base64 编码），使用应用的 Client Secret 生成，用于验证请求来自 Shoplazza
- `X-Shoplazza-Shop-Domain` string

  产生该事件的店铺域名

  **示例：** `example.myshoplaza.com`
- `X-Shoplazza-Api-Version` string

  序列化 payload 使用的 API 版本

  **示例：** `2025-06`
- `X-Shoplazza-Deduplication-ID` string

  本次推送的去重 ID，同一事件重发时保持不变，用于幂等去重

## 请求体

**数据结构 | 示例**

- `collection` object

  - `id` string

    专辑 ID
  - `title` string

    专辑名称
  - `handle` string

    专辑 handle（URL 友好的唯一别名）
  - `description` string

    专辑描述
  - `MetaKeyword` string

    SEO 关键词列表
  - `meta_title` string

    专辑的 SEO 标题
  - `meta_description` string

    专辑的 SEO 描述
  - `sort_order` string

    专辑内商品的排序规则（取值见创建专辑接口）
  - `url` string

    C 端专辑详情页 URL（不含店铺域名）
  - `created_at` string

    专辑创建时间（ISO-8601 格式）
  - `updated_at` string

    专辑最后更新时间（ISO-8601 格式）
  - `image` object

    专辑封面

    - `src` string

      图片来源 URL
    - `path` string

      图片路径（不含域名；`src` 含域名）
    - `width` integer

      图片宽度（像素）
    - `height` integer

      图片高度（像素）

```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
    }
  }
}
```