Skip to main content

Customers create

Webhookcustomers/create

Triggered when a C-end customer is created.

Requires the customer access scope. Minimum supported version: 202007.

Request headers​

    X-Shoplazza-Topicstring

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

    Example: orders/create
    X-Shoplazza-Hmac-Sha256string

    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-Domainstring

    The domain of the store that generated the event

    Example: example.myshoplaza.com
    X-Shoplazza-Api-Versionstring

    The API version used to serialize the payload

    Example: 2025-06
    X-Shoplazza-Deduplication-IDstring

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

Request body​

  • customer object
    idstring

    Unique customer ID

    namestring

    Customer name

    first_namestring

    Customer's first name

    last_namestring

    Customer's last name

    emailstring

    Customer's email address

    phonestring

    Customer's phone number

    phone_area_codestring

    Area code of the customer's phone number

    contact_typestring

    Contact type, either email or phone

    accepts_marketingboolean

    Whether the customer has subscribed to email marketing

    accepts_sms_marketingboolean

    Whether the customer has subscribed to SMS marketing

    subscribed_flaginteger

    The customer's email marketing subscription status

    sms_subscribed_flaginteger

    The customer's SMS subscription status flag

    registeredboolean

    Whether the customer has registered

    free_taxboolean

    Whether the customer is tax-exempt

    tagsstring

    Customer tags

    sourcestring

    Source of the customer data

    orders_countinteger

    Total number of orders placed by the customer

    total_spentstring

    Total amount spent by the customer

    first_order_atstring

    Time of the customer's first order

    last_order_atstring

    Time of the customer's most recent order

    created_atstring

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

    updated_atstring

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

    default_address object

    The customer's default address

    idstring

    Address record ID

    customer_idstring

    ID of the customer this address belongs to

    first_namestring

    Recipient's first name

    last_namestring

    Recipient's last name

    namestring

    Recipient's full name (first_name + last_name)

    companystring

    Company name

    address1string

    Street address

    address2string

    Second address line

    citystring

    City

    areastring

    Area (district or county)

    provincestring

    Province or state

    province_codestring

    Province or state code

    countrystring

    Country

    country_codestring

    ISO country code

    country_namestring

    Full country name

    zipstring

    ZIP/postal code

    phonestring

    Contact phone number

    phone_area_codestring

    Phone area code

    emailstring

    Contact email associated with the address

    genderstring

    Recipient's gender

    defaultboolean

    Whether this is the default address

    addresses object[]

    List of all the customer's addresses

  • Array [
    • idstring

    Address record ID

    customer_idstring

    ID of the customer this address belongs to

    first_namestring

    Recipient's first name

    last_namestring

    Recipient's last name

    namestring

    Recipient's full name (first_name + last_name)

    companystring

    Company name

    address1string

    Street address

    address2string

    Second address line

    citystring

    City

    areastring

    Area (district or county)

    provincestring

    Province or state

    province_codestring

    Province or state code

    countrystring

    Country

    country_codestring

    ISO country code

    country_namestring

    Full country name

    zipstring

    ZIP/postal code

    phonestring

    Contact phone number

    phone_area_codestring

    Phone area code

    emailstring

    Contact email associated with the address

    genderstring

    Recipient's gender

    defaultboolean

    Whether this is the default address

  • ]