Webhook payload

When a campaign has a Webhook URL set, Spinlet POSTs this JSON body to it on every spin — whether the visitor won a prize or not.

Example

{
  "event": "spin",
  "campaignId": "GgWeR0P766UbLI7cYXYI",
  "campaignName": "Summer sale",
  "email": "visitor@example.com",
  "prizeLabel": "10% off",
  "prizeCode": "SPIN10",
  "pageUrl": "https://yourshop.com/collections/all",
  "variant": "a",
  "createdAt": "2026-09-29T18:32:07.000Z"
}

Fields

Key	Type	Description
event	string	Always "spin" today — reserved in case other event types are added later.
campaignId	string	The Spinlet campaign ID (matches the URL in your dashboard).
campaignName	string	The campaign's name, as set in the dashboard.
email	string	The email address the visitor entered before spinning.
prizeLabel	string	The prize’s display label, e.g. "10% off" or "No luck".
prizeCode	string \| null	The discount/coupon code tied to the prize, or null if that prize has no code.
pageUrl	string \| null	The URL of the page the widget was shown on, or null if it couldn't be determined.
variant	"a" \| "b"	Which A/B test variant the visitor saw. Always "a" if A/B testing is off for this campaign.
createdAt	string	ISO 8601 timestamp of when the spin was recorded, in UTC.

Delivery details

Method & headers — POST with Content-Type: application/json.
Timeout — the request is cancelled after 5 seconds.
Best-effort, no retries — if your endpoint is slow, down, or returns an error, we log it and move on. A failed webhook never affects the spin result the visitor already received, and we don’t currently retry failed deliveries.
No signature header — requests aren’t currently signed. If you need to verify the source, route the webhook through Zapier, Make, or n8n rather than trusting the request directly.