About customers

Sync your store customers to Yotpo, to be used as contacts for messaging. This includes information about your shop's customers such as their contact details, their order history, and whether they've agreed to receive marketing messaging.


Customers endpoints are available for Yotpo SMS & Email.

Good to know

  • While you can create your customers explicitly using the below endpoints, in certain scenarios customer records can also be enriched implicitly by Yotpo after interacting with a customer. For example, Yotpo will automatically enrich customer records for shoppers who reviewed a product or engaged with Loyalty features.
  • To manage subscriptions for various types of messaging, for example, SMS messaging, review requests, etc., dedicated endpoints should be used.

Customer endpoints

  • Retrieve customers - Retrieves a list of past and existing customers from your Yotpo store. Use this endpoint to check if a customer was registered successfully with Yotpo.
  • Create or update custom customer event -Enrich customer profiles with additional events that represent customer actions. These events can be consumed in Yotpo SMS & Email flows.

Customer properties

Listed below are all of the available properties for customers. To see which properties are required per endpoint, refer to the endpoint pages below.

external_idstringA unique customer identifier. This ID will be used to identify the customer in our database, it is used for creating profiles, attributing events to profiles, and merging profiles. If you don’t have a unique identifier for the customer, avoid using this property. If you’re using Shopify as your eCommerce platform, please use the Shopify customer ID.
emailstringThe email address of the customer.
phone_numberstringThe phone number of the customer in E.164 format.

This number will be used for SMS messaging.
first_namestringThe first name of the customer.
last_namestringThe last name of the customer.
genderstringValid values:
- F (Female)
- M (Male)
- Other
account_created_atdatetimeThe date the account was originally created in the store. Must be in ISO 8601 format.
account_statusstringThe status of the store account.
Valid values:
- enabled
- disabled
- invited
- declined
default_languagestringThe default language of the customer's account in ISO 639-1 format.
default_currencystringThe default currency for this customer. Must be in ISO 4217 format. See currency codes
tagsstringComma-separated string of tags. The merchant can later segment customers by tags.
addressobjectThe default address for this customer. See address object description