Outbound webhooks

Related: Developer hub · REST API · MCP

Requirements

• Paid Rewards Fuel plan
• API key with hooks scope (included on new keys)
• HTTPS webhook URL (Make Custom webhook or Zapier Catch Hook)

Event types

Event	When it fires
contest.created	New contest created (including copies)
contest.started	Contest status set to live
contest.ended	Contest ended (manual, scheduled, or automatic)
entry.created	Any new entry (isNewContestant in payload)
entry.confirmed	Pending entry confirmed (e.g. newsletter opt-in)
contestant.created	First-time email enters a contest
winner.picked	Winners selected (manual, scheduled, or auto)

Make.com setup

1. Create a scenario with Webhooks → Custom webhook.
2. Copy the webhook URL.
3. Register it with Rewards Fuel (example below).
4. In Make, map type and data from the JSON body.

Register a webhook

curl -X POST https://app.rewardsfuel.com/api/v1/webhooks \
  -H "Authorization: Bearer rf_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://hook.eu1.make.com/YOUR_SCENARIO",
    "label": "Make — new entrants",
    "events": ["contestant.created", "entry.created", "winner.picked"]
  }'

The response includes a signing secret (whsec_…). Store it securely — it is only returned once at creation. Set optional contestId to limit delivery to a single contest.

Delivery payload

{
  "id": "evt_…",
  "type": "contestant.created",
  "createdAt": "2026-06-11T12:00:00.000Z",
  "accountId": 42,
  "data": {
    "contest": { "id": 7, "name": "Summer Giveaway" },
    "contestant": {
      "email": "user@example.com",
      "firstEntryId": 991
    }
  }
}

Verification headers

• X-RF-Event — event type (same as type in body)
• X-RF-Delivery-Id — unique delivery id
• X-RF-Timestamp — Unix timestamp
• X-RF-Signature — sha256= HMAC of {timestamp}.{rawBody}

Webhook API

Method	Path	Description
GET	/webhooks/events	List supported event types
GET	/webhooks	List your registered hooks
POST	/webhooks	Create hook (returns secret once)
PATCH	/webhooks/:id	Update URL, events, or enabled flag
DELETE	/webhooks/:id	Remove hook
POST	/webhooks/:id/test	Send test payload

Base URL: https://app.rewardsfuel.com/api/v1. Dashboard users can also manage hooks at /api/account/webhooks while signed in.

Choosing events for Make

• New entrant only → contestant.created
• Every entry action (bonus methods too) → entry.created
• Contest closed → contest.ended
• Winner selected → winner.picked

Generate keys in Account → API keys & integrations. Questions? Contact us.