- Blitz Rocket API DocumentationGetting StartedAPI ReferenceWebhooksReferral Tracking
Webhooks
Receive real-time notifications for contest events
On this page
Webhooks
Webhooks allow external services to send data to Blitz Rocket when events happen in your application. Use webhooks to automatically create contest entries when users sign up on your platform, or to award points when purchases are made.
How Webhooks Work
- You configure a webhook URL in your external system (e.g., Shopify, Stripe, or your custom backend)
- When an event occurs (signup, purchase), your system sends an HTTP POST request to the Blitz Rocket webhook endpoint
- Blitz Rocket processes the event, creates or updates entries, and awards points
Available Webhook Endpoints
| Webhook | Endpoint | Purpose |
|---|---|---|
| Signup | POST /api/webhooks/signup/:contestId | Create entries from external signups |
| Purchase | POST /api/webhooks/purchase/:contestId | Track purchases from external stores |
Webhook Security
Each webhook connection has a secret key that you can configure in your team settings. When sending webhook requests, include the secret in the request body or as a header to verify authenticity.
Supported Integrations
Blitz Rocket supports webhooks from:
- Shopify — Automatic order and customer webhooks
- Stripe — Payment and subscription webhooks
- Custom — Any system that can send HTTP POST requests
Webhook vs API
| Feature | Webhooks | REST API |
|---|---|---|
| Direction | External → Blitz Rocket | Your code → Blitz Rocket |
| Authentication | Webhook secret | API key |
| Use case | Event-driven automation | On-demand operations |
| Real-time | Yes (push) | No (pull) |
Use webhooks when you want automated, event-driven entry creation and purchase tracking. Use the REST API when you need fine-grained control over operations.