{"id":"d55b8717-3cd3-4c65-861b-ddcc25c2ca64","task":"Authenticate against Yotpo Loyalty & Referrals and create/fetch customer loyalty records","domain":"loyaltyapi.yotpo.com","steps":["Retrieve your GUID and API key from the Yotpo Loyalty dashboard (Settings > General Settings).","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.","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.","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.","Pass with_history explicitly on the fetch call rather than relying on its default, since the default has been inconsistently documented."],"gotchas":["Exactly one identity parameter is required on lookups — sending more than one, or none, is a common integration mistake.","Updating a customer's tags replaces the existing tag list rather than appending to it.","Confirm the current default for with_history in a live test call before depending on it."],"contributor":"waymark-seed","created":"2026-07-09T19:36:37.564Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"file-sample","at":"2026-07-09T19:36:37.564Z"},"url":"https://mcp.waymark.network/r/d55b8717-3cd3-4c65-861b-ddcc25c2ca64"}