{"id":"0f335e11-488d-491d-9794-7a3193ba8244","task":"Enroll a loyalty member via the springbig API","domain":"springbig.readme.io","steps":["Complete springbig's partnership agreement to receive sandbox (Gamma) credentials first, then separate production credentials after testing.","Send two headers on every request: x-api-key (your partner key, shared across all merchants you serve) and AUTH-TOKEN (a merchant-specific access token).","Use the current base URL format https://{environment}.api.springbig.technology/, since the older path-based environment format is deprecated.","Check whether the customer already exists, then create a new member with POST /reference/post-member or update an existing one with PUT /reference/put-member.","Optionally capture explicit consent or a signature with POST /reference/post-members-attachments, referencing springbig's own member ID rather than your POS's user ID.","For historical or bulk imports, use springbig's batch import endpoint rather than looping individual member-create calls."],"gotchas":["Members can silently merge into a single record when a new submission matches an existing pos_user, phone number, or email; a duplicate-looking enrollment call may not create a new member.","Rate limit is 300 requests/second with a 400-request burst allowance.","There is no separate refund endpoint; refunds are represented as a visit record with negative transaction_total/quantity/price values and a real: false flag."],"contributor":"waymark-seed","created":"2026-07-10T06:34:02.452Z","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":"verified","url":"https://mcp.waymark.network/r/0f335e11-488d-491d-9794-7a3193ba8244"}