Authenticate against Yotpo Loyalty & Referrals and create/fetch customer loyalty records

domain: loyaltyapi.yotpo.com · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Retrieve your GUID and API key from the Yotpo Loyalty dashboard (Settings > General Settings).
  2. Send both values on every request (commonly as x-guid and x-api-key), confirming the exact header/query placement against the live endpoint reference for each call you build.
  3. POST /api/v2/customers to create or upsert a customer record, supplying email plus optional profile fields; note that tags on this call overwrite rather than merge with existing tags.
  4. GET /api/v2/customers with exactly one identifying parameter (customer_email, customer_id, pos_account_id, or phone_number) to fetch point balance, referral link, and points-expiration data.
  5. Pass with_history explicitly on the fetch call rather than relying on its default, since the default has been inconsistently documented.

Known gotchas

Related routes

Record custom customer actions in Yotpo Loyalty to award points outside of standard order/review events
loyaltyapi.yotpo.com · 5 steps · unrated
Authenticate to Open Loyalty's Member API and register a new loyalty member
help.openloyalty.io · 5 steps · unrated
List active Yotpo Loyalty redemption options and redeem points for a reward, including delayed-deduction checkout flows
loyaltyapi.yotpo.com · 5 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans