How integration works
End-to-End Workflow
1. Setup Integrator Access
- Create or manage your integrator in SCALAR Web portal
- Ensure integrator has necessary module-level permissions for the event types you want to receive
2. Create Webhook Subscription
- Navigate to Datahub Subscriptions configuration
- Select subscription method: "Webhook"
- Provide your webhook endpoint URL (must be HTTPS)
- Generated webhook secret for HMAC signature validation
- Select event groups and specific events to subscribe to
- Configure batch settings (batch size, maximum waiting time)
- Optionally add custom headers and enable overflow protection
3. Test Your Webhook
- Use the webhook test feature to send sample events to your endpoint
- Verify your endpoint responds with a 200 status code
- Check that your application processes the test payload correctly
4. Receive Event Data
- SCALAR sends event batches to your webhook endpoint
- Your endpoint processes and acknowledges each batch
- SCALAR retries failed deliveries automatically
5. Monitor and Maintain
- Track webhook delivery status and metrics
- Check Webhook developer metrics for integration insights
- Notifications (Push, Email) for any kind of configurations impact on the subscriptions
- Update custom headers or batch settings as needed
Updated about 2 hours ago