Customers

Get all customers

• If filtering by reference_id then multiple customers for the same client may share the same reference_id, so you will receive an array of customers for zero (representing no customers found) or more customers. However, the response will always be a 200 success.

Get a customer

• If there is no reference_id for the customer then an empty string is returned.

• If searching by name and phone, then all values first_name, last_name, and phone must be provided.

• If retrieving a customer by either email, or name and phone, then the response will be a 302 redirect to the matching customer record, or 404 if not found.

Create a customer

Creation of new customers is currently limited to the fields below.

• At a minimum, first_name and either email or phone are required.
• reference_id is an identifier you can set that is applicable only to your application. You could use this to store a mapping to that same customer in your system. You can not see reference_id values assigned by other applications.
• country should be specified as a two-character ISO 3166-1 country code.

Update a customer

Modification of customers is currently limited to the first_name, last_name, phone, email, tags, image, primary_address, shipping_address, reference_id and accepts_marketing.

Webhooks

Here is a list of the supported webhook topics.

customers/created

When a customer is created. You will receive the complete customer.

customers/updated

When a customer is updated. You will receive the complete customer after the modifications have been applied.

You also may provide the following attribute filters:

• name - if either first_name or last_name are updated.
• phone
• email
• address - if either primary_address or shipping_address are updated.
• tags
• image
• accepts_marketing

customers/deleted

When a customer is deleted. You will receive the complete customer.