Customer Events

When subscribed to the Customer events webhook, the following event data will be received:

Event Body

Field nameDescriptionJSON TypeData Type
idThe unique ID of the event. May be used to ensure that an event is not processed twice in the case of a webhook that is re-tried due to an error or timeout.string
createdDateA timestamp signifying when the event was generated.
Format: YYYY-MM-DDThh:mm:ss[.SSS]Z
Note: millisecond is denoted as optional [.SSS]
stringdatetime
typeEvent type:
customer
string
actionEvent action:
created
updated
string
payloadThe payload of the event. The contents of this object depend on the type of event.objectpayload

payload object

Field nameDescriptionJSON TypeData Type
customerIdThe customer Idstring
businessIdsThe business Id that this customer is associated with:

Examples:

1. Customer is attached to first business:
action: updated
businessIds: ["123"]

2. Vagaro sync occurs, all business would be associated
action: updated
businessIds: ["123", "456", "789"]

3. Customer is removed from business: "456"
action: updated
businessIds: ["123", "789"]
arraystring
customerFirstNameThe customer's first namestring
customerLastNameThe customer's last namestring
businessGroupIdThe unique identifier for a multilocation group.string
emailCustomer's email addressstring
mobilePhoneMobile/cell phone numberstring
dayPhoneDay phone numberstring
nightPhoneNight phone numberstring
streetAddressAddressstring
cityCity namestring
regionCodeThe state, province, or region code (e.g., "CA" for California, "CA-ON" for Ontario, "AU-NSW" for New South Wales)string
regionNameThe state, province, or region name (e.g., "California", "Ontario", "New South Wales").string
countryCodeThe country code (e.g., "US", "CA", "AU", "GB").string
countryNameThe country name (e.g., "United States of America", "Canada", "Australia", "United Kingdom").string
postalCodeThe postal or ZIP code (e.g., "90001" for USA, "M5V 2T6" for Canada, "2000" for Australia, "SW1A 1AA" for the UK).string
createdDateThe date/time that the customer was created
Format: YYYY-MM-DDThh:mm:ss[.SSS]Z
Note: millisecond is denoted as optional [.SSS]
stringdatetime
createdByUser that created the customer recordstring
modifiedDateThe date/time that the customer was modified.
Format: YYYY-MM-DDThh:mm:ss[.SSS]Z
Note: millisecond is denoted as optional [.SSS]
stringdatetime
modifiedByUser that modified/deleted the customer recordstring

Example

{
    "id": "254FA623-D2B0-4785-A07D-A1A7059C74FF",
    "createdDate": "2024-03-15T00:00:00Z",
    "type": "customer",
    "action": "updated",
    "payload": {
        "customerId": "4CB231BAD3B26B7DE53FE5832A54A7B1",
        "businessIds": ["U2FsdGVkX18zRbwyUxRZaHNTYGwjKCpDdAkKP4eUDsE="],
        "customerFirstName": "Johnny",
        "customerLastName": "Smith",
        "businessGroupId": "tYKEZF-L445YEDnCx0TIfA==",
        "email": "[email protected]",
        "mobilePhone": "9145551212",
        "dayPhone": "",
        "nightPhone": "",
        "streetAddress": "498 Edgecombe Avenue Manhattan",
        "city": "New York",
        "regionCode": "NY",
        "regionName": "New York",
        "countryCode": "US",      
        "countryName": "United States of America",      
        "postalCode": "10030",
        "createdDate": "2023-07-10T08:50:00Z",
        "createdBy": "GVkX18zRbwyUxRZaHNTYGwjK",
        "modifiedDate": "2023-08-10T08:50:00Z",
        "modifiedBy": "GVkX18zRbwyUxRZaHNTYGwjK"
    }
}

What’s Next