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, review requests, dedicated endpoints should be used.

Customer endpoints

Create or update customer - Create/update a customer in the Yotpo platform
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.

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.

General customer properties

Field	Type	Description
external_id	string	A 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.
email	string	The email address of the customer.
phone_number	string	The phone number of the customer in E.164 format.
first_name	string	The first name of the customer.
last_name	string	The last name of the customer.
gender	string	Valid values: F (Female) M (Male) Other
account_created_at	datetime	The date the account was originally created in the store. Must be in ISO 8601 format.
account_updated_at	datetime	The timestamp when the customer's account was last updated. Must be in ISO 8601 format (in UTC).
account_status	string	The status of the store account. Valid values: enabled disabled invited declined
default_language	string	The default language of the customer's account in ISO 639-1 format.
default_currency	string	The default currency for this customer. Must be in ISO 4217 format. See currency codes
tags	string	A comma-separated string of tags. The merchant can later segment customers by tags.
address	object	The default address for this customer. See address object description
lists	array	An array of lists the customer belongs to, each containing an ID and a timestamp.
custom_properties	json	The custom customer properties that enrich the customer profile. For example, skin type, hair color, etc. For this parameter to populate with values in the response, it must be requested by adding the ‘include_custom_properties=true' query parameter.

Yotpo Reviews

Field	Type	Description
yotpo_ugc	object	An object containing the customer's user-generated content information
yotpo_ugc.total_reviews	integer	The total number of reviews submitted by the customer
yotpo_ugc.avg_product_rating	integer	The average product rating given by the customer
yotpo_ugc.avg_site_rating	float	The average rating of the site/store given by the customer
yotpo_ugc.total_avg_rating	float	The total average rating given by the customer (combining products and site/store ratings)
yotpo_ugc.sentiment_avg_site	double	The total average sentiment score given by the customer (combining products and site/store scores). Learn more
yotpo_ugc.top_topics	list	An array of top topics (themes) mentioned in all of the customer's reviews
yotpo_ugc.last_star_rating	integer	The star rating of the customer's last review
yotpo_ugc.last_review_date	datetime	The timestamp for when the customer last submitted a review. ISO 8601 format (in UTC)
yotpo_ugc.last_sentiment	double	The sentiment score of the customer's last review

Yotpo Loyalty & Referrals

Field	Type	Description
yotpo_loyalty	object	An object containing the customer's loyalty and referrals information
yotpo_loyalty.points_earned	integer	The total number of loyalty points earned by the customer
yotpo_loyalty.points_balance	integer	The current balance of loyalty points for the customer
yotpo_loyalty.last_seen_at	datetime	The timestamp when the customer was last seen or engaged with the loyalty program. This includes making a purchase with your store. ISO 8601 format (in UTC)
yotpo_loyalty.total_redemptions	integer	The total number of times the customer has redeemed loyalty points
yotpo_loyalty.total_points_redeemed	integer	The total number of loyalty points redeemed by the customer
yotpo_loyalty.vip_tier_name	string	The name of the customer's current VIP tier status (e.g., "Gold", "Silver", etc.)
yotpo_loyalty.successful_referrals	integer	The total number of successful referrals made by the customer
yotpo_loyalty.referrals_made_and_clicked	integer	The total number of referrals made by the customer and clicked on by others
yotpo_loyalty.is_referred_by_other_customer	boolean	Indicates whether the customer was referred by another customer
yotpo_loyalty.points_expire_date	datetime	The timestamp when the customer's loyalty points are set to expire. ISO 8601 format (in UTC)
yotpo_loyalty.credit_balance_amount	integer	The amount of store credit available to the customer in the default currency of the store
yotpo_loyalty.credit_balance_customer_currency	string	The store credit amount in the customer's preferred currency
yotpo_loyalty.is_opt_in	boolean	Indicates whether the customer has opted into the loyalty program
yotpo_loyalty.opt_in_date	datetime	The timestamp for when the customer opted into the loyalty program. ISO 8601 format (in UTC)
yotpo_loyalty.opt_out_date	datetime	The timestamp for when the customer opted out of the loyalty program. ISO 8601 format (in UTC)
yotpo_loyalty.has_store_account	boolean	Indicates whether the customer has a store account
yotpo_loyalty.referred_by_customer	string	The email address of the customer who referred this customer to the loyalty program
yotpo_loyalty.vip_entry_date	datetime	The timestamp for when the customer entered the VIP tier. ISO 8601 format (in UTC)
yotpo_loyalty.vip_expiration_date	datetime	The timestamp for when the customer's VIP tier membership is set to expire. ISO 8601 format (in UTC)