• Example searches: “transaction”, “CreateOrder”, “/v2/locations”, “inventory”, “delete customer”
You are viewing an old version of the API

Customer updated

EVENT customer.updated

Published when a customer is updated. For more information, see Use Customer Webhooks.

Updates to the following customer fields do not invoke a customer.updated event: cards and segment_ids. In addition, the customer object in the event notification does not include these fields.


Permissions
CUSTOMERS_READ
Name Description
merchant_id
string

The ID of the seller associated with the event.

type
string

The type of event. For this object, the value is customer.updated.

event_id
string

The unique ID of the event, which is used for idempotency support.

created_at
string

Read only The timestamp of when the event was created, in RFC 3339 format.

Examples for January 25th, 2020 6:25:34pm Pacific Standard Time:

UTC: 2020-01-26T02:25:34Z

Pacific Standard Time with UTC offset: 2020-01-25T18:25:34-08:00

data
CustomerUpdatedWebhookData

The data associated with the event.

Examples

You are viewing an old version of the API
Example payload
{
  "merchant_id": "G7MMEBVW021Q4",
  "type": "customer.updated",
  "event_id": "b4ce4698-00de-4b5d-a771-4941b3913b34",
  "created_at": "2020-11-09T21:38:29Z",
  "data": {
    "type": "customer",
    "id": "A0AP25A6SCVTH8JES9BX01GXM4",
    "object": {
      "customer": {
        "created_at": "2020-07-09T18:23:01.795Z",
        "creation_source": "THIRD_PARTY",
        "email_address": "jenkins+smorly@squareup.com",
        "family_name": "Smorly",
        "given_name": "Jenkins",
        "id": "A0AP25A6SCVTH8JES9BX01GXM4",
        "phone_number": "+13477947111",
        "preferences": {
          "email_unsubscribed": false
        },
        "updated_at": "2020-11-09T21:38:30Z",
        "version": 1
      }
    }
  }
}

Share Feedback

Thanks for visiting the Square API documentation. What's on your mind?