Customer Account Event

Event structure and samples for Customer Accounts.


Note: Version 2 Webhooks can contain more that one event per webhook. Please see “V2 Webhook Structure” for more details.


Event Fields

Property Format Description
billing_address_line_1 string First Line of the Billing Address
billing_address_line_2 string or null Second Line of the Billing Address, if set
billing_city string The Billing Address City
billing_country_code string (ISO 3166-1 alpha-2) The Billing Address Country Code
billing_postal_code string The Billing Address Post Code
billing_state string The Billing State
client object Object containing the client information, see below
company_name string or null The Company name of the Customer, if set
created_at datetime (ISO8601) Date and time the record was created
created_by object or null Object containing the created_by information, if set, see below
custom_reference string or null The Custom reference
delivery_address_line_1 string or null First Line of the Delivery Address, if set
delivery_address_line_2 string or null Second Line of the Delivery Address, if set
delivery_city string or null The Delivery Address City, if set
delivery_country_code string (ISO 3166-1 alpha-2) The Delivery Address Country Code, if set
delivery_postal_code string or null The Delivery Address Post Code, if set
delivery_state string or null The Delivery State, if set
edited_at datetime (ISO8601) Date and time the record was edited
edited_by object or null Object containing the edited_by information, if set, see below
email string The Email Address of the Customer
event_id string The ID of the Event
event_source string The Source that triggered the event
event_type string This will be “customer_account.create” or “customer_account.update”
first_name string The First Name of the Customer
id string The ID of the Record
last_name string The Last Name of the Customer
legacy_id string Legacy ID of the record, if set
metadata string or null String used to store custom metadata, if set
status string The Status of the Customer Account, see options below
title string or null Title for the Customer Name, if set

client Object Fields

Property Format Description
id string ID of the record

created_by Object Fields

Property Format Description
id string ID of the record

edited_by Object Fields

Property Format Description
id string ID of the record
{
   "id":{VALUE},
   "idempotency_key":{VALUE},
   "sent_at":{VALUE},
   "client":
   { 
      "id":{VALUE} 
   },
   "events":[
      {
         "email":{VALUE},
         "company_name":{VALUE},
         "first_name":{VALUE},
         "last_name":{VALUE},
         "billing_address_line_1":{VALUE},
         "billing_address_line_2":{VALUE},
         "billing_city":{VALUE},
         "billing_postal_code":{VALUE},
         "billing_country_code":{VALUE},
         "id":{VALUE},
         "event_id":{VALUE},
         "legacy_id":{VALUE},
         "created_at":{VALUE},
         "status":{VALUE},
         "title":{VALUE},
         "edited_at":{VALUE},
         "delivery_address_line_1":{VALUE},
         "delivery_address_line_2":{VALUE},
         "delivery_city":{VALUE},
         "delivery_postal_code":{VALUE},
         "delivery_country_code":{VALUE},
         "custom_reference":{VALUE},
         "event_type":{VALUE},
         "event_source":{VALUE},
         "billing_state":{VALUE},
         "delivery_state":{VALUE},
         "metadata":{VALUE},
         "created_by":{
            "id":{VALUE}
         },
         "edited_by":{
            "id":{VALUE}
         },
         "client":{
            "id":{VALUE}
         }, 
      }
   ]
}

Note: Property display order for documentation purposes, actual order may vary.

Notes:

  • Properties displayed in alphabetical order for documentation purposes, actual order will vary.


Property Possible Values
status active
inactive

Customer Account Event - Sample - Record Creation

Customer Account Event - Structure

The fields that have been updated for this webhook are:

Field Sample Value
email “james.hetfield@email.com”
company_name null
first_name “James”
last_name “Hetfield”
billing_address_line_1 “Utility House”
billing_address_line_2 “32-36 Prospect Street”
billing_city “Hull”
billing_postal_code “HU2 8PX”
billing_country_code GB
id “CA01G420EJ9D44P1VQWR”
event_id “HI02KL45YJ6ZR7JZ2DQR”
legacy_id null
created_at “2024-04-15T10:28:51Z”
status “active”
title “Mr”
edited_at “2024-04-15T10:28:51Z”
delivery_address_line_1 null
delivery_address_line_2 null
delivery_city null
delivery_postal_code null
delivery_country_code null
custom_reference null
event_type “customer_account.create”
event_source “Portal”
billing_state null
delivery_state null
metadata null
client:id “CL01LG420EJ9DP1VQWR9”
created_by:id “CU01LG420EJ9VWP1VQWR”
edited_by:id “CU01LG420EJ9VWP1VQWR”
{
   "id":{VALUE},
   "idempotency_key":{VALUE},
   "sent_at":{VALUE},
   "client":
   { 
      "id":{VALUE} 
   },
   "events":[
      {
         "email":{VALUE},
         "company_name":{VALUE},
         "first_name":{VALUE},
         "last_name":{VALUE},
         "billing_address_line_1":{VALUE},
         "billing_address_line_2":{VALUE},
         "billing_city":{VALUE},
         "billing_postal_code":{VALUE},
         "billing_country_code":{VALUE},
         "id":{VALUE},
         "event_id":{VALUE},
         "legacy_id":{VALUE},
         "created_at":{VALUE},
         "status":{VALUE},
         "title":{VALUE},
         "edited_at":{VALUE},
         "delivery_address_line_1":{VALUE},
         "delivery_address_line_2":{VALUE},
         "delivery_city":{VALUE},
         "delivery_postal_code":{VALUE},
         "delivery_country_code":{VALUE},
         "custom_reference":{VALUE},
         "event_type":{VALUE},
         "event_source":{VALUE},
         "billing_state":{VALUE},
         "delivery_state":{VALUE},
         "metadata":{VALUE},
         "created_by":{
            "id":{VALUE}
         },
         "edited_by":{
            "id":{VALUE}
         },
         "client":{
            "id":{VALUE}
         }, 
      }
   ]
}

Note: Property display order for documentation purposes, actual order may vary.

  • Last modified: 2024/04/16 09:08