Record custom customer actions in Yotpo Loyalty to award points outside of standard order/review events
domain: loyaltyapi.yotpo.com · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
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.
Known 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.
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?