---
title: "Customer created"
description: "Occurs whenever a customer is created."
doc_type: openapi
doc_category: openapi
doc_version: v20270301
source_url:
  html: 'https://developer.shopline.com/docs/webhook/customers/customer-add'
  md: 'https://developer.shopline.com/docs/webhook/customers/customer-add.md'
---
# Customer created

Occurs whenever a customer is created.

- **API Version:** v20270301
- **API Type:** Webhook
- **API Protocol:** RESTful

## Request

### Request Headers

* `Content-Type`

  string (required)

  The field must be set to the fixed value `application/json; charset=utf-8`.

* `X-Shopline-Topic`

  string (required)

  The unique identifier for the event.

* `X-Shopline-Hmac-Sha256`

  string (required)

  The signature of the request. Upon receiving the request, you must [verify the signature](https://developer.shopline.com/docs/apps/api-instructions-for-use/generate-and-verify-signatures.md#post-requests) to confirm the authenticity and integrity of the data.

* `X-Shopline-Shop-Domain`

  string (required)

  The store domain.

* `X-Shopline-Shop-Id`

  string (required)

  The store ID.

* `X-Shopline-Merchant-Id`

  string (required)

  The merchant ID.

* `X-Shopline-API-Version`

  string (required)

  The API version.

* `X-Shopline-Webhook-Id`

  string (required)

  The ID of this Webhook event.

### Request Body

* `accepts_marketing`

  boolean

  Whether the customer accepts subscribing to marketing information via email.
  * `true`: Accepts
  * `false`: Does not accept
  :::danger{title="DEPRECATED"}
  This parameter is deprecated from API version v20250601.
  :::
  

* `accepts_marketing_updated_at`

  string

  The date and time when the customer's subscription status for email marketing was last updated. Format: [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html).
  :::danger{title="DEPRECATED"}
  This parameter is deprecated from API version v20250601.
  :::
  

* `accepts_mobile_marketing`

  boolean

  Whether the customer accepts subscribing to marketing information via SMS.
  * `true`: Accepts
  * `false`: Does not accept
  :::danger{title="DEPRECATED"}
  This parameter is deprecated from API version v20250601.
  :::

* `accepts_mobile_marketing_updated_at`

  string

  The date and time when the customer's subscription status for SMS marketing was last updated. Format: [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html).
  :::danger{title="DEPRECATED"}
  This parameter is deprecated from API version v20250601.
  :::

* `addresses`

  array<object>

  A list of customer addresses.

  * `address1`

    string

    The first line of the address. This typically includes information such as the street address or a post office box number.

  * `address2`

    string

    The second line of the address. This typically includes information such as apartment, suite, or unit number. 

  * `city`

    string

    The city in the address. 

  * `company`

    string

    The customer's company.

  * `country`

    string

    The country or region in the address. 
    

  * `country_code`

    string

    A two-letter country or region code that follows the [ISO 3166-1 (alpha 2)](https://www.iso.org/glossary-for-iso-3166.html) standard, used to identify a specific country or region in the address.

  * `customer_id`

    string

    The unique identifier for the customer.

  * `default`

    boolean

    Whether the address is set as the default address.
    * `true`: Set as the default address.
    * `false`: Not set as the default address. 

  * `first_name`

    string

    The customer's first name. 

  * `id`

    string

    The unique identifier for the address. 

  * `last_name`

    string

    The customer's last name. 

  * `phone`

    string

    The customer's mobile phone number.

  * `province`

    string

    The province or state in the address. 

  * `province_code`

    string

    The code for the province or state, represented by a custom code or the portion after the hyphen (-) in the [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2) code. For example, `RI` in `US-RI` or `ENG` in `GB-ENG`.

  * `zip`

    string

    The postal code information of the address. 

* `asid`

  string

  The unique app-scoped user identifier provided after the customer logs in via Facebook.

* `attributes`

  array<object>

  Additional customer information (formatted as key-value pairs) collected during registration.

  * `key`

    string

    The key or name of the attribute.

  * `value`

    string

    The value of the attribute. 

* `birthday`

  string

  The customer's birthday. Format: `yyyyMMdd`.

* `created_at`

  string

  The date and time when the customer was created. Format: [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html).

* `currency`

  string

  The currency used by the customer to place an order. The value of this parameter is a three-letter currency code that follows the [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) standard. 

* `default_address`

  object

  The default address.

  * `address1`

    string

    The first line of the address. This typically includes information such as the street address or a post office box number.

  * `address2`

    string

    The second line of the address. This typically includes information such as apartment, suite, or unit number. 

  * `city`

    string

    The city in the address. 

  * `company`

    string

    The company name.

  * `country`

    string

    The country or region in the address. 
    

  * `country_code`

    string

    A two-letter country or region code that follows the [ISO 3166-1 (alpha 2)](https://www.iso.org/glossary-for-iso-3166.html) standard, used to identify a specific country or region in the address. 

  * `customer_id`

    string

    The unique identifier for the customer.

  * `default`

    boolean

    Whether the address is set as the default address.
    * `true`: Set as the default address.
    * `false`: Not set as the default address. 

  * `first_name`

    string

    The customer's first name. 

  * `id`

    string

    The unique identifier for the address. 

  * `last_name`

    string

    The customer's last name. 

  * `phone`

    string

    The customer's mobile phone number.

  * `province`

    string

    The province or state in the address. 

  * `province_code`

    string

    The code for the province or state, represented by a custom code or the portion after the hyphen (-) in the [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2) code. For example, `RI` in `US-RI` or `ENG` in `GB-ENG`.

  * `zip`

    string

    The postal code information of the address. 

* `email`

  string

  The customer's email address.

* `email_marketing_consent`

  object

  The information about the email marketing subscription.

  * `consent_collected_from`

    string

    The source of the subscription information.

  * `consent_updated_at`

    string

    The date and time when the subscription status was updated. Format: [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html). 

  * `opt_in_level`

    integer

    The subscription method. Valid values are:
    * `0`: Unknown
    * `1`: Single opt-in
    * `2`: Confirmed opt-in
    
    The default value depends on whether **Email marketing consent checkbox is preselected** is enabled under **Settings > Customer Account > Marketing options** in the SHOPLINE Admin. 
    
    * Enabled: The default value is `2`.
    * Disabled: The default value is `1`.

  * `state`

    integer

    Email subscription status. Valid values are: 
    
    * `0`: Unsubscribed
    * `1`: Subscribed
    * `2`: Not subscribed
    

* `email_subscribe_flag`

  integer

  The final subscription status of email marketing. The value is determined based on the parameters within `email_marketing_consent`. Valid values are: 
  
  * `0`: Unsubscribed
  * `1`: Subscribed
  * `2`: Not subscribed

* `first_name`

  string

  The customer's first name. 

* `gender`

  string

  The customer's gender. Valid values are: 
  
  
  * `0`: Unknown
  * `1`: Male
  * `2`: Female
  * `3`: Secret

* `id`

  string

  The customer's unique ID .

* `language`

  string

  The customer's language.

* `last_name`

  string

  The customer's last name. 
  

* `last_order_id`

  string

  The order number of the most recent order.
  :::danger{title="DEPRECATED"}
  This parameter is deprecated from API version v20250601.
  :::

* `mobile_subscribe_flag`

  integer

  The final subscription status of SMS marketing. The value is determined based on the parameters within `sms_marketing_consent`. Valid values are: 
  
  * `0`: Unsubscribed
  * `1`: Subscribed
  * `2`: Not subscribed

* `multipass_identifier`

  string

  A unique identifier for the customer that logs in with [Multipass](https://developer.shopline.com/docs/apps/multipass.md?_highlight=multip).

* `nick_name`

  string

  The customer's nickname.

* `note`

  string

  The merchant's notes on the customer.

* `orders_count`

  long

  The number of orders.    
  :::danger{title="DEPRECATED"}
  This parameter is deprecated from API version v20250601.
  :::

* `phone`

  string

  The customer's mobile phone number.

* `sms_marketing_consent`

  object

  The information about the SMS marketing subscription.

  * `consent_collected_from`

    string

    The source of the subscription information.

  * `consent_updated_at`

    string

    The date and time when the subscription status was updated. Format: [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html). 

  * `opt_in_level`

    integer

    The subscription method. Valid values are:
    * `0`: Unknown
    * `1`: Single opt-in
    * `2`: Confirmed opt-in

  * `state`

    integer

    SMS subscription status. Valid values are: 
    
    * `0`: Unsubscribed
    * `1`: Subscribed
    * `2`: Not subscribed

* `social_customer`

  string

  The customer's unique ID on social media.
  :::danger{title="DEPRECATED"}
  This parameter is deprecated from API version v20250601.
  :::
  

* `state`

  string

  The customer's status. Valid values are: 
  
  * `0`: Blacklisted
  * `1`: Not invited
  * `2`: Invited
  * `3`: Registered

* `tags`

  string

  The tags to be added to the customer, with multiple tags separated by commas.

* `total_spent`

  string

  Total cost amount.
  :::danger{title="DEPRECATED"}
  This parameter is deprecated from API version v20250601.
  :::

* `updated_at`

  string

  The date and time when the customer was updated. Format: [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html). 

* `verified_email`

  boolean

  Whether the email has been verified.  
  * `true`: Verified
  * `false`: Unverified

## Response

### Status Codes

* `200`

  After receiving a webhook notification from SHOPLINE, you must respond with the following format: 
  
  ``` HTTP/1.1 200 OK ```
  
  For more information about how to subscribe to webhooks and webhook response rules, refer to [Webhook overview](https://developer.shopline.com/docs/apps/api-instructions-for-use/webhooks/overview.md).

### Response Body

#### 200

_No response body_

## OpenAPI Definition

```json
{
  "tags": [
    "Customer created"
  ],
  "description": "Occurs whenever a customer is created.",
  "externalDocs": {
    "description": "| Event Group | Event Identification |\n| :------: | :------: |\n|customers        |customers/create        |\n",
    "url": "",
    "errorTableDescription": ""
  },
  "operationId": "ew7v8rGE",
  "parameters": [
    {
      "name": "Content-Type",
      "in": "header",
      "description": "The field must be set to the fixed value `application/json; charset=utf-8`.",
      "required": true,
      "schema": {
        "name": "Content-Type",
        "type": "string",
        "example": "application/json; charset=utf-8"
      }
    },
    {
      "name": "X-Shopline-Topic",
      "in": "header",
      "description": "The unique identifier for the event.",
      "required": true,
      "style": "string",
      "schema": {
        "name": "X-Shopline-Topic",
        "description": "The unique identifier for the event.",
        "type": "string",
        "example": "orders/edited"
      },
      "example": "orders/edited"
    },
    {
      "name": "X-Shopline-Hmac-Sha256",
      "in": "header",
      "description": "The signature of the request. Upon receiving the request, you must [verify the signature](https://developer.shopline.com/docs/apps/api-instructions-for-use/generate-and-verify-signatures.md#post-requests) to confirm the authenticity and integrity of the data.",
      "required": true,
      "style": "string",
      "schema": {
        "name": "X-Shopline-Hmac-Sha256",
        "description": "The signature of the request. Upon receiving the request, you must [verify the signature](https://developer.shopline.com/docs/apps/api-instructions-for-use/generate-and-verify-signatures.md#post-requests) to confirm the authenticity and integrity of the data.",
        "type": "string",
        "example": "XWmrwMey6OsLMeiZKwP4FppHH3cmAiiJJAweH5Jo4bM="
      },
      "example": "XWmrwMey6OsLMeiZKwP4FppHH3cmAiiJJAweH5Jo4bM="
    },
    {
      "name": "X-Shopline-Shop-Domain",
      "in": "header",
      "description": "The store domain.",
      "required": true,
      "style": "string",
      "schema": {
        "name": "X-Shopline-Shop-Domain",
        "description": "The store domain.",
        "type": "string",
        "example": "example.myshopline.com"
      },
      "example": "example.myshopline.com"
    },
    {
      "name": "X-Shopline-Shop-Id",
      "in": "header",
      "description": "The store ID.",
      "required": true,
      "style": "string",
      "schema": {
        "name": "X-Shopline-Shop-Id",
        "description": "The store ID.",
        "type": "string",
        "example": "1610418123456"
      },
      "example": "1610418123456"
    },
    {
      "name": "X-Shopline-Merchant-Id",
      "in": "header",
      "description": "The merchant ID.",
      "required": true,
      "style": "string",
      "schema": {
        "name": "X-Shopline-Merchant-Id",
        "description": "The merchant ID.",
        "type": "string",
        "example": "2000001234"
      },
      "example": "2000001234"
    },
    {
      "name": "X-Shopline-API-Version",
      "in": "header",
      "description": "The API version.",
      "required": true,
      "style": "string",
      "schema": {
        "name": "X-Shopline-API-Version",
        "description": "The API version.",
        "type": "string",
        "example": "v20250601"
      },
      "example": "v20250601"
    },
    {
      "name": "X-Shopline-Webhook-Id",
      "in": "header",
      "description": "The ID of this Webhook event.",
      "required": true,
      "style": "string",
      "schema": {
        "name": "X-Shopline-Webhook-Id",
        "description": "The ID of this Webhook event.",
        "type": "string",
        "example": "b54557e48a5fbf7d70bcd043"
      },
      "example": "b54557e48a5fbf7d70bcd043"
    }
  ],
  "requestBody": {
    "content": {
      "application/json": {
        "schema": {
          "name": "body",
          "type": "object",
          "properties": {
            "accepts_marketing": {
              "name": "accepts_marketing",
              "description": "Whether the customer accepts subscribing to marketing information via email.\n* `true`: Accepts\n* `false`: Does not accept\n:::danger{title=\"DEPRECATED\"}\nThis parameter is deprecated from API version v20250601.\n:::\n",
              "type": "boolean"
            },
            "accepts_marketing_updated_at": {
              "name": "accepts_marketing_updated_at",
              "description": "The date and time when the customer's subscription status for email marketing was last updated. Format: [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html).\n:::danger{title=\"DEPRECATED\"}\nThis parameter is deprecated from API version v20250601.\n:::\n",
              "type": "string",
              "example": "2022-12-16T11:06:11+08:00"
            },
            "accepts_mobile_marketing": {
              "name": "accepts_mobile_marketing",
              "description": "Whether the customer accepts subscribing to marketing information via SMS.\n* `true`: Accepts\n* `false`: Does not accept\n:::danger{title=\"DEPRECATED\"}\nThis parameter is deprecated from API version v20250601.\n:::",
              "type": "boolean"
            },
            "accepts_mobile_marketing_updated_at": {
              "name": "accepts_mobile_marketing_updated_at",
              "description": "The date and time when the customer's subscription status for SMS marketing was last updated. Format: [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html).\n:::danger{title=\"DEPRECATED\"}\nThis parameter is deprecated from API version v20250601.\n:::",
              "type": "string",
              "example": "2022-12-16T11:06:11+08:00"
            },
            "addresses": {
              "name": "addresses",
              "description": "A list of customer addresses.",
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "address1": {
                    "name": "address1",
                    "description": "The first line of the address. This typically includes information such as the street address or a post office box number.",
                    "type": "string",
                    "example": "7720 Cherokee Road"
                  },
                  "address2": {
                    "name": "address2",
                    "description": "The second line of the address. This typically includes information such as apartment, suite, or unit number. ",
                    "type": "string",
                    "example": "Apartment 2"
                  },
                  "city": {
                    "name": "city",
                    "description": "The city in the address. ",
                    "type": "string",
                    "example": "Hagerman"
                  },
                  "company": {
                    "name": "company",
                    "description": "The customer's company.",
                    "type": "string"
                  },
                  "country": {
                    "name": "country",
                    "description": "The country or region in the address. \n",
                    "type": "string",
                    "example": "United States"
                  },
                  "country_code": {
                    "name": "country_code",
                    "description": "A two-letter country or region code that follows the [ISO 3166-1 (alpha 2)](https://www.iso.org/glossary-for-iso-3166.html) standard, used to identify a specific country or region in the address.",
                    "type": "string",
                    "example": "US"
                  },
                  "customer_id": {
                    "name": "customer_id",
                    "description": "The unique identifier for the customer.",
                    "type": "string",
                    "example": "2007347234"
                  },
                  "default": {
                    "name": "default",
                    "description": "Whether the address is set as the default address.\n* `true`: Set as the default address.\n* `false`: Not set as the default address. ",
                    "type": "boolean"
                  },
                  "first_name": {
                    "name": "first_name",
                    "description": "The customer's first name. ",
                    "type": "string",
                    "example": "Bob"
                  },
                  "id": {
                    "name": "id",
                    "description": "The unique identifier for the address. ",
                    "type": "string",
                    "example": "SL201UA4840334721187149827"
                  },
                  "last_name": {
                    "name": "last_name",
                    "description": "The customer's last name. ",
                    "type": "string",
                    "example": "James"
                  },
                  "phone": {
                    "name": "phone",
                    "description": "The customer's mobile phone number.",
                    "type": "string",
                    "example": "008613987985473"
                  },
                  "province": {
                    "name": "province",
                    "description": "The province or state in the address. ",
                    "type": "string",
                    "example": "Kentucky"
                  },
                  "province_code": {
                    "name": "province_code",
                    "description": "The code for the province or state, represented by a custom code or the portion after the hyphen (-) in the [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2) code. For example, `RI` in `US-RI` or `ENG` in `GB-ENG`.",
                    "type": "string"
                  },
                  "zip": {
                    "name": "zip",
                    "description": "The postal code information of the address. ",
                    "type": "string",
                    "example": "40202"
                  }
                },
                "example": {
                  "address1": "7720 Cherokee Road",
                  "address2": "Apartment 2",
                  "city": "Hagerman",
                  "company": null,
                  "country": "United States",
                  "country_code": "US",
                  "customer_id": "2007347234",
                  "default": null,
                  "first_name": "Bob",
                  "id": "SL201UA4840334721187149827",
                  "last_name": "James",
                  "phone": "008613987985473",
                  "province": "Kentucky",
                  "province_code": null,
                  "zip": "40202"
                }
              }
            },
            "asid": {
              "name": "asid",
              "description": "The unique app-scoped user identifier provided after the customer logs in via Facebook.",
              "type": "string"
            },
            "attributes": {
              "name": "attributes",
              "description": "Additional customer information (formatted as key-value pairs) collected during registration.",
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "key": {
                    "name": "key",
                    "description": "The key or name of the attribute.",
                    "type": "string",
                    "example": "plugin.membership.invite_code"
                  },
                  "value": {
                    "name": "value",
                    "description": "The value of the attribute. ",
                    "type": "string",
                    "example": "WELCOME"
                  }
                },
                "example": {
                  "key": "plugin.membership.invite_code",
                  "value": "WELCOME"
                }
              }
            },
            "birthday": {
              "name": "birthday",
              "description": "The customer's birthday. Format: `yyyyMMdd`.",
              "type": "string",
              "example": "20210831"
            },
            "created_at": {
              "name": "created_at",
              "description": "The date and time when the customer was created. Format: [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html).",
              "type": "string",
              "example": "2022-12-16T11:06:11+08:00"
            },
            "currency": {
              "name": "currency",
              "description": "The currency used by the customer to place an order. The value of this parameter is a three-letter currency code that follows the [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) standard. ",
              "type": "string",
              "example": "USD"
            },
            "default_address": {
              "name": "default_address",
              "description": "The default address.",
              "type": "object",
              "properties": {
                "address1": {
                  "name": "address1",
                  "description": "The first line of the address. This typically includes information such as the street address or a post office box number.",
                  "type": "string",
                  "example": "7720 Cherokee Road"
                },
                "address2": {
                  "name": "address2",
                  "description": "The second line of the address. This typically includes information such as apartment, suite, or unit number. ",
                  "type": "string",
                  "example": "Apartment 2"
                },
                "city": {
                  "name": "city",
                  "description": "The city in the address. ",
                  "type": "string",
                  "example": "Hagerman"
                },
                "company": {
                  "name": "company",
                  "description": "The company name.",
                  "type": "string",
                  "example": "Joy"
                },
                "country": {
                  "name": "country",
                  "description": "The country or region in the address. \n",
                  "type": "string",
                  "example": "United States"
                },
                "country_code": {
                  "name": "country_code",
                  "description": "A two-letter country or region code that follows the [ISO 3166-1 (alpha 2)](https://www.iso.org/glossary-for-iso-3166.html) standard, used to identify a specific country or region in the address. ",
                  "type": "string",
                  "example": "US"
                },
                "customer_id": {
                  "name": "customer_id",
                  "description": "The unique identifier for the customer.",
                  "type": "string",
                  "example": "2007347234"
                },
                "default": {
                  "name": "default",
                  "description": "Whether the address is set as the default address.\n* `true`: Set as the default address.\n* `false`: Not set as the default address. ",
                  "type": "boolean"
                },
                "first_name": {
                  "name": "first_name",
                  "description": "The customer's first name. ",
                  "type": "string",
                  "example": "Bob"
                },
                "id": {
                  "name": "id",
                  "description": "The unique identifier for the address. ",
                  "type": "string",
                  "example": "SL201UA4840334721187149827"
                },
                "last_name": {
                  "name": "last_name",
                  "description": "The customer's last name. ",
                  "type": "string",
                  "example": "James"
                },
                "phone": {
                  "name": "phone",
                  "description": "The customer's mobile phone number.",
                  "type": "string",
                  "example": "008613977865436"
                },
                "province": {
                  "name": "province",
                  "description": "The province or state in the address. ",
                  "type": "string",
                  "example": "Kentucky"
                },
                "province_code": {
                  "name": "province_code",
                  "description": "The code for the province or state, represented by a custom code or the portion after the hyphen (-) in the [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2) code. For example, `RI` in `US-RI` or `ENG` in `GB-ENG`.",
                  "type": "string"
                },
                "zip": {
                  "name": "zip",
                  "description": "The postal code information of the address. ",
                  "type": "string",
                  "example": "40202"
                }
              },
              "example": {
                "address1": "7720 Cherokee Road",
                "address2": "Apartment 2",
                "city": "Hagerman",
                "company": "Joy",
                "country": "United States",
                "country_code": "US",
                "customer_id": "2007347234",
                "default": null,
                "first_name": "Bob",
                "id": "SL201UA4840334721187149827",
                "last_name": "James",
                "phone": "008613977865436",
                "province": "Kentucky",
                "province_code": null,
                "zip": "40202"
              }
            },
            "email": {
              "name": "email",
              "description": "The customer's email address.",
              "type": "string",
              "example": "steve@example.com"
            },
            "email_marketing_consent": {
              "name": "email_marketing_consent",
              "description": "The information about the email marketing subscription.",
              "type": "object",
              "properties": {
                "consent_collected_from": {
                  "name": "consent_collected_from",
                  "description": "The source of the subscription information.",
                  "type": "string",
                  "example": "extInfo"
                },
                "consent_updated_at": {
                  "name": "consent_updated_at",
                  "description": "The date and time when the subscription status was updated. Format: [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html). ",
                  "type": "string",
                  "example": "2021-08-31T02:20:26+08:00"
                },
                "opt_in_level": {
                  "name": "opt_in_level",
                  "description": "The subscription method. Valid values are:\n* `0`: Unknown\n* `1`: Single opt-in\n* `2`: Confirmed opt-in\n\nThe default value depends on whether **Email marketing consent checkbox is preselected** is enabled under **Settings > Customer Account > Marketing options** in the SHOPLINE Admin. \n\n* Enabled: The default value is `2`.\n* Disabled: The default value is `1`.",
                  "type": "integer"
                },
                "state": {
                  "name": "state",
                  "description": "Email subscription status. Valid values are: \n\n* `0`: Unsubscribed\n* `1`: Subscribed\n* `2`: Not subscribed\n",
                  "type": "integer"
                }
              },
              "example": {
                "consent_collected_from": "extInfo",
                "consent_updated_at": "2021-08-31T02:20:26+08:00",
                "opt_in_level": null,
                "state": null
              }
            },
            "email_subscribe_flag": {
              "name": "email_subscribe_flag",
              "description": "The final subscription status of email marketing. The value is determined based on the parameters within `email_marketing_consent`. Valid values are: \n\n* `0`: Unsubscribed\n* `1`: Subscribed\n* `2`: Not subscribed",
              "type": "integer"
            },
            "first_name": {
              "name": "first_name",
              "description": "The customer's first name. ",
              "type": "string",
              "example": "Bob"
            },
            "gender": {
              "name": "gender",
              "description": "The customer's gender. Valid values are: \n\n\n* `0`: Unknown\n* `1`: Male\n* `2`: Female\n* `3`: Secret",
              "type": "string"
            },
            "id": {
              "name": "id",
              "description": "The customer's unique ID .",
              "type": "string",
              "example": "2007347234"
            },
            "language": {
              "name": "language",
              "description": "The customer's language.",
              "type": "string",
              "example": "en"
            },
            "last_name": {
              "name": "last_name",
              "description": "The customer's last name. \n",
              "type": "string",
              "example": "James"
            },
            "last_order_id": {
              "name": "last_order_id",
              "description": "The order number of the most recent order.\n:::danger{title=\"DEPRECATED\"}\nThis parameter is deprecated from API version v20250601.\n:::",
              "type": "string",
              "example": "200066283289389"
            },
            "mobile_subscribe_flag": {
              "name": "mobile_subscribe_flag",
              "description": "The final subscription status of SMS marketing. The value is determined based on the parameters within `sms_marketing_consent`. Valid values are: \n\n* `0`: Unsubscribed\n* `1`: Subscribed\n* `2`: Not subscribed",
              "type": "integer"
            },
            "multipass_identifier": {
              "name": "multipass_identifier",
              "description": "A unique identifier for the customer that logs in with [Multipass](https://developer.shopline.com/docs/apps/multipass.md?_highlight=multip).",
              "type": "string",
              "example": "extInfo"
            },
            "nick_name": {
              "name": "nick_name",
              "description": "The customer's nickname.",
              "type": "string",
              "example": "Bob James"
            },
            "note": {
              "name": "note",
              "description": "The merchant's notes on the customer.",
              "type": "string"
            },
            "orders_count": {
              "name": "orders_count",
              "description": "The number of orders.    \n:::danger{title=\"DEPRECATED\"}\nThis parameter is deprecated from API version v20250601.\n:::",
              "type": "long"
            },
            "phone": {
              "name": "phone",
              "description": "The customer's mobile phone number.",
              "type": "string",
              "example": "008613987675435"
            },
            "sms_marketing_consent": {
              "name": "sms_marketing_consent",
              "description": "The information about the SMS marketing subscription.",
              "type": "object",
              "properties": {
                "consent_collected_from": {
                  "name": "consent_collected_from",
                  "description": "The source of the subscription information.",
                  "type": "string",
                  "example": "extInfo"
                },
                "consent_updated_at": {
                  "name": "consent_updated_at",
                  "description": "The date and time when the subscription status was updated. Format: [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html). ",
                  "type": "string",
                  "example": "2022-12-16T11:06:11+08:00"
                },
                "opt_in_level": {
                  "name": "opt_in_level",
                  "description": "The subscription method. Valid values are:\n* `0`: Unknown\n* `1`: Single opt-in\n* `2`: Confirmed opt-in",
                  "type": "integer"
                },
                "state": {
                  "name": "state",
                  "description": "SMS subscription status. Valid values are: \n\n* `0`: Unsubscribed\n* `1`: Subscribed\n* `2`: Not subscribed",
                  "type": "integer"
                }
              },
              "example": {
                "consent_collected_from": "extInfo",
                "consent_updated_at": "2022-12-16T11:06:11+08:00",
                "opt_in_level": null,
                "state": null
              }
            },
            "social_customer": {
              "name": "social_customer",
              "description": "The customer's unique ID on social media.\n:::danger{title=\"DEPRECATED\"}\nThis parameter is deprecated from API version v20250601.\n:::\n",
              "type": "string",
              "example": "7566553464365"
            },
            "state": {
              "name": "state",
              "description": "The customer's status. Valid values are: \n\n* `0`: Blacklisted\n* `1`: Not invited\n* `2`: Invited\n* `3`: Registered",
              "type": "string"
            },
            "tags": {
              "name": "tags",
              "description": "The tags to be added to the customer, with multiple tags separated by commas.",
              "type": "string"
            },
            "total_spent": {
              "name": "total_spent",
              "description": "Total cost amount.\n:::danger{title=\"DEPRECATED\"}\nThis parameter is deprecated from API version v20250601.\n:::",
              "type": "string"
            },
            "updated_at": {
              "name": "updated_at",
              "description": "The date and time when the customer was updated. Format: [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html). ",
              "type": "string",
              "example": "2022-09-07T10:53:31+08:00"
            },
            "verified_email": {
              "name": "verified_email",
              "description": "Whether the email has been verified.  \n* `true`: Verified\n* `false`: Unverified",
              "type": "boolean"
            }
          },
          "example": {
            "accepts_marketing": null,
            "accepts_marketing_updated_at": "2022-12-16T11:06:11+08:00",
            "accepts_mobile_marketing": null,
            "accepts_mobile_marketing_updated_at": "2022-12-16T11:06:11+08:00",
            "addresses": null,
            "asid": null,
            "attributes": null,
            "birthday": "20210831",
            "created_at": "2022-12-16T11:06:11+08:00",
            "currency": "USD",
            "default_address": {
              "address1": "7720 Cherokee Road",
              "address2": "Apartment 2",
              "city": "Hagerman",
              "company": "Joy",
              "country": "United States",
              "country_code": "US",
              "customer_id": "2007347234",
              "default": null,
              "first_name": "Bob",
              "id": "SL201UA4840334721187149827",
              "last_name": "James",
              "phone": "008613977865436",
              "province": "Kentucky",
              "province_code": null,
              "zip": "40202"
            },
            "email": "steve@example.com",
            "email_marketing_consent": {
              "consent_collected_from": "extInfo",
              "consent_updated_at": "2021-08-31T02:20:26+08:00",
              "opt_in_level": null,
              "state": null
            },
            "email_subscribe_flag": null,
            "first_name": "Bob",
            "gender": null,
            "id": "2007347234",
            "language": "en",
            "last_name": "James",
            "last_order_id": "200066283289389",
            "mobile_subscribe_flag": null,
            "multipass_identifier": "extInfo",
            "nick_name": "Bob James",
            "note": null,
            "orders_count": null,
            "phone": "008613987675435",
            "sms_marketing_consent": {
              "consent_collected_from": "extInfo",
              "consent_updated_at": "2022-12-16T11:06:11+08:00",
              "opt_in_level": null,
              "state": null
            },
            "social_customer": "7566553464365",
            "state": null,
            "tags": null,
            "total_spent": null,
            "updated_at": "2022-09-07T10:53:31+08:00",
            "verified_email": null
          }
        }
      }
    },
    "required": true
  },
  "responses": {
    "200": {
      "description": "After receiving a webhook notification from SHOPLINE, you must respond with the following format: \n\n``` HTTP/1.1 200 OK ```\n\nFor more information about how to subscribe to webhooks and webhook response rules, refer to [Webhook overview](https://developer.shopline.com/docs/apps/api-instructions-for-use/webhooks/overview.md)."
    }
  },
  "method": "post",
  "info": {
    "title": "Customer created",
    "version": "v20270301"
  }
}
```