# Customers update

> Triggered when a C-end customer is updated. Reference for the Shoplazza customers/update webhook: request headers and payload fields.

**Webhook** customers/update

Triggered when a C-end customer is updated.

Requires the `customer` [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**

- `customer` object

  - `id` string

    Unique customer ID
  - `name` string

    Customer name
  - `first_name` string

    Customer's first name
  - `last_name` string

    Customer's last name
  - `email` string

    Customer's email address
  - `phone` string

    Customer's phone number
  - `phone_area_code` string

    Area code of the customer's phone number
  - `contact_type` string

    Contact type, either email or phone
  - `accepts_marketing` boolean

    Whether the customer has subscribed to email marketing
  - `accepts_sms_marketing` boolean

    Whether the customer has subscribed to SMS marketing
  - `subscribed_flag` integer

    The customer's email marketing subscription status
  - `sms_subscribed_flag` integer

    The customer's SMS subscription status flag
  - `registered` boolean

    Whether the customer has registered
  - `free_tax` boolean

    Whether the customer is tax-exempt
  - `tags` string

    Customer tags
  - `source` string

    Source of the customer data
  - `orders_count` integer

    Total number of orders placed by the customer
  - `total_spent` string

    Total amount spent by the customer
  - `first_order_at` string

    Time of the customer's first order
  - `last_order_at` string

    Time of the customer's most recent order
  - `created_at` string

    Time when the customer was created, in ISO-8601 format
  - `updated_at` string

    Time when the customer was last updated, in ISO-8601 format
  - `default_address` object

    The customer's default address

    - `id` string

      Address record ID
    - `customer_id` string

      ID of the customer this address belongs to
    - `first_name` string

      Recipient's first name
    - `last_name` string

      Recipient's last name
    - `name` string

      Recipient's full name (first_name + last_name)
    - `company` string

      Company name
    - `address1` string

      Street address
    - `address2` string

      Second address line
    - `city` string

      City
    - `area` string

      Area (district or county)
    - `province` string

      Province or state
    - `province_code` string

      Province or state code
    - `country` string

      Country
    - `country_code` string

      ISO country code
    - `country_name` string

      Full country name
    - `zip` string

      ZIP/postal code
    - `phone` string

      Contact phone number
    - `phone_area_code` string

      Phone area code
    - `email` string

      Contact email associated with the address
    - `gender` string

      Recipient's gender
    - `default` boolean

      Whether this is the default address
  - `addresses` object[]

    List of all the customer's addresses

    *   Array [

    - `id` string

      Address record ID
    - `customer_id` string

      ID of the customer this address belongs to
    - `first_name` string

      Recipient's first name
    - `last_name` string

      Recipient's last name
    - `name` string

      Recipient's full name (first_name + last_name)
    - `company` string

      Company name
    - `address1` string

      Street address
    - `address2` string

      Second address line
    - `city` string

      City
    - `area` string

      Area (district or county)
    - `province` string

      Province or state
    - `province_code` string

      Province or state code
    - `country` string

      Country
    - `country_code` string

      ISO country code
    - `country_name` string

      Full country name
    - `zip` string

      ZIP/postal code
    - `phone` string

      Contact phone number
    - `phone_area_code` string

      Phone area code
    - `email` string

      Contact email associated with the address
    - `gender` string

      Recipient's gender
    - `default` boolean

      Whether this is the default address
    *   ]

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