{"id":"9f50cb86-4cdb-4fa8-bf3f-32c5054c552f","task":"Record custom customer actions in Yotpo Loyalty to award points outside of standard order/review events","domain":"loyaltyapi.yotpo.com","steps":["In the Yotpo Loyalty admin, create a Custom Action earning campaign with a specific action_name and point value.","When the qualifying event happens in your app, call POST /api/v2/actions with type: CustomAction, a customer identifier (customer_email or customer_id), and an action_name matching the configured campaign exactly.","Optionally override reward_points for a one-off bonus without changing the underlying campaign configuration.","Pass ip_address and user_agent if this action might also complete a referral requirement.","Confirm the award by fetching the customer with with_history=true and checking that a matching history entry appears."],"gotchas":["action_name must match a pre-existing, active Custom Action campaign exactly; calling it with an unconfigured name silently awards nothing.","This endpoint is not for purchases — orders go through the separate Create Order endpoint.","Backdating with created_at changes the recorded completed_at timestamp, which matters for bulk historical imports."],"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/9f50cb86-4cdb-4fa8-bf3f-32c5054c552f"}