# 客户创建

**Webhook** customers/create

C 端客户创建时触发。

需要 `customer` [访问权限](/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，同一事件重发时保持不变，用于幂等去重

## 请求体

**数据结构 | 示例**

- `customer` object

  - `id` string

    顾客的唯一标识
  - `name` string

    顾客的名字
  - `first_name` string

    顾客的名
  - `last_name` string

    顾客的姓
  - `email` string

    顾客的电子邮件地址
  - `phone` string

    顾客的电话号码
  - `phone_area_code` string

    顾客电话号码的区号
  - `contact_type` string

    联系方式类型，邮箱或电话
  - `accepts_marketing` boolean

    顾客是否订阅了营销邮件
  - `accepts_sms_marketing` boolean

    顾客是否订阅了短信营销活动
  - `subscribed_flag` integer

    顾客的营销订阅状态
  - `sms_subscribed_flag` integer

    顾客的短信订阅状态标志
  - `registered` boolean

    顾客是否已注册
  - `free_tax` boolean

    顾客是否享有税收豁免
  - `tags` string

    顾客标签
  - `source` string

    顾客数据来源
  - `orders_count` integer

    顾客的累计下单数量
  - `total_spent` string

    顾客的累计消费金额
  - `first_order_at` string

    顾客首次下单时间
  - `last_order_at` string

    顾客最后一次下单时间
  - `created_at` string

    顾客创建时间，ISO-8601 格式
  - `updated_at` string

    顾客最后更新时间，ISO-8601 格式
  - `default_address` object

    顾客设置的默认地址

    - `id` string

      地址记录的 ID
    - `customer_id` string

      所属顾客的 ID
    - `first_name` string

      收件人的名
    - `last_name` string

      收件人的姓
    - `name` string

      收件人的全名（first\_name + last\_name 拼接）
    - `company` string

      公司名称
    - `address1` string

      主街道地址
    - `address2` string

      第二行地址
    - `city` string

      城市
    - `area` string

      区域（区/县）
    - `province` string

      省/州
    - `province_code` string

      省/州代码
    - `country` string

      国家
    - `country_code` string

      ISO 国家代码
    - `country_name` string

      国家全称
    - `zip` string

      邮政编码
    - `phone` string

      联系电话
    - `phone_area_code` string

      电话区号
    - `email` string

      与地址关联的联系邮箱
    - `gender` string

      收件人的性别
    - `default` boolean

      是否为默认地址
  - `addresses` object[]

    顾客的所有地址列表

    *   Array \[

    - `id` string

      地址记录的 ID
    - `customer_id` string

      所属顾客的 ID
    - `first_name` string

      收件人的名
    - `last_name` string

      收件人的姓
    - `name` string

      收件人的全名（first\_name + last\_name 拼接）
    - `company` string

      公司名称
    - `address1` string

      主街道地址
    - `address2` string

      第二行地址
    - `city` string

      城市
    - `area` string

      区域（区/县）
    - `province` string

      省/州
    - `province_code` string

      省/州代码
    - `country` string

      国家
    - `country_code` string

      ISO 国家代码
    - `country_name` string

      国家全称
    - `zip` string

      邮政编码
    - `phone` string

      联系电话
    - `phone_area_code` string

      电话区号
    - `email` string

      与地址关联的联系邮箱
    - `gender` string

      收件人的性别
    - `default` boolean

      是否为默认地址
    *   \]

```json
{
  "customer": {
    "id": "string",
    "name": "string",
    "first_name": "string",
    "last_name": "string",
    "email": "string",
    "phone": "string",
    "phone_area_code": "string",
    "contact_type": "string",
    "accepts_marketing": true,
    "accepts_sms_marketing": true,
    "subscribed_flag": 0,
    "sms_subscribed_flag": 0,
    "registered": true,
    "free_tax": true,
    "tags": "string",
    "source": "string",
    "orders_count": 0,
    "total_spent": "string",
    "first_order_at": "string",
    "last_order_at": "string",
    "created_at": "string",
    "updated_at": "string",
    "default_address": {
      "id": "string",
      "customer_id": "string",
      "first_name": "string",
      "last_name": "string",
      "name": "string",
      "company": "string",
      "address1": "string",
      "address2": "string",
      "city": "string",
      "area": "string",
      "province": "string",
      "province_code": "string",
      "country": "string",
      "country_code": "string",
      "country_name": "string",
      "zip": "string",
      "phone": "string",
      "phone_area_code": "string",
      "email": "string",
      "gender": "string",
      "default": true
    },
    "addresses": [
      {
        "id": "string",
        "customer_id": "string",
        "first_name": "string",
        "last_name": "string",
        "name": "string",
        "company": "string",
        "address1": "string",
        "address2": "string",
        "city": "string",
        "area": "string",
        "province": "string",
        "province_code": "string",
        "country": "string",
        "country_code": "string",
        "country_name": "string",
        "zip": "string",
        "phone": "string",
        "phone_area_code": "string",
        "email": "string",
        "gender": "string",
        "default": true
      }
    ]
  }
}
```