Skip to main content

Customer API Overview

Use the Customer API to manage customer details, addresses, and other information.

The Customer API allows you to generate tokens inside your client-side applications to authenticate requests to get all customer orders.

You are able to use a customer token with an implicit access token. This is recommended for client-side interactions. Alternatively, you can use a client_credentials access token. This is recommended for back-end interactions.

The Customer Object​

AttributeTypeDescription
idstringThe unique identifier for this customer.
typestringThe type represents the object being returned.
namestringThe name of the customer.
emailstringThe email of the customer.
passwordbooleantrue if the customer has a password, false otherwise.
external_refstringThe optional external ID reference. For example, this could be an external reference from a separate company system. The maximum length is 2048 characters. Default is null.

The meta Object​

AttributeTypeDescription
meta.created_atstringThe creation date of this customer.
meta.updated_atstringThe last updated date of this customer.

Sample response​

{
"data": {
"type": "customer",
"id": "f260b17a-390f-4b37-bf9d-f62c45a95865",
"name": "Ron Swanson",
"email": "ron@swanson.com",
"external_ref": "16bedceb-8b2d-4f82-a973-b0a8d8432708",
"password": true,
"meta": {
"timestamps": {
"created_at": "2017-01-11T18:44:45Z",
"updated_at": "2017-05-31T04:12:12Z"
}
}
}
}
Ask External AI