Developer platform
Read promotion data, import participants, add bonus entries, and queue eligible participant workflows from the systems your team already uses.
Run promotions with Claude, ChatGPT or Codex using the Revup MCP.
POST /api/v1/promotions/123/participants/entries Idempotency-Key: crm-bonus-ada-2026-05-21 x-api-key: rvup_v1_... Content-Type: application/json { "email": "ada@example.com", "entries": 25, "title": "VIP launch bonus" }
{
"success": true,
"request_id": "2f4a8f2c0d4a6e9b7c1d2e3f",
"data": {
"participant_id": 456,
"promotion_id": 123,
"manual_key": "manual_points_api_7b1d...",
"entries_added": 25,
"total_entries": 26,
"participant": {}
}
}
Connect Revup to the systems you already use. Read promotion and customer data, import participants, award bonus entries, and build custom workflows through the Revup API.
Create participants individually or in batches, then award bonus entries from your own systems. Revup handles retries safely so the same request won’t accidentally create duplicate entries.
Read account-level contacts with cursor pagination for use in a CRM, data platform, reporting tool, or internal system.
Create participants individually or in batches, optionally update existing matches, send supported custom promotion fields, and receive per-row results.
Read promotion, participant, contact, and winner collections with cursor pagination for reporting and downstream analysis.
For newly created participant imports, opt in to queue an active attached form-submitted workflow after confirming contact permission, and receive the immediate trigger status per row.
Create an account-scoped key under Account → API, select its scopes, and optionally restrict it to selected promotions.
Review authentication, endpoints, requests, responses, pagination, and retry guidance in the official API documentation.
Send the key in the x-api-key header, follow the documented retry guidance for writes, and validate the response.
/api/v1/promotionsList non-variant promotions visible to the key with cursor pagination.
/api/v1/promotions/{promotion_id}/participantsList non-deleted participants with cursor pagination and optional entry ledger data.
/api/v1/promotions/{promotion_id}/participantsCreate participants individually or in batches, with optional updates to existing matches.
/api/v1/promotions/{promotion_id}/participants/entriesAdd bonus entries to an existing participant with retry protection.
/api/v1/contactsList account contacts visible to the key with cursor pagination.
/api/v1/promotions/{promotion_id}/winnersList winners and prize assignment details with cursor pagination.
Quick answers about building with Revup and finding current technical guidance.
Build custom workflows around your promotion data. Read promotions, participants, contacts, and winners, import participants, award bonus entries, and trigger supported Revup workflows from your own systems.
Yes. Connect Revup to your CRM, data warehouse, reporting tools, internal apps, or other systems to move promotion and customer data where you need it.
Our API documentation covers authentication, available endpoints, request and response formats, scopes, pagination, and implementation details.
Create an API key from Account → API, choose the scopes and promotion access you need, then authenticate requests with your key. From there, you can start reading data or building workflows right away.
