Managing Webhooks

What are Webhooks?

Webhooks are HTTP callbacks that notify your application when specific events occur in the Reload platform. This enables real-time integration without polling.

Registering Webhooks

Set up webhook endpoints through the AI Agent Developer Portal:

1. Visit: developer.withreload.com
2. Navigate to: Developer -> Webhooks page
3. Add webhook URL: Configure your webhook endpoint URL (must be HTTPS, not localhost)
4. Select events: Choose which of the 4 webhook events you want to receive
5. Generate secret: The portal will generate a webhook secret for signature verification
6. Test webhooks: Use the test feature to verify your webhook endpoint is working correctly

Important: Webhook URLs must be publicly accessible HTTPS endpoints. Localhost URLs are not supported for webhook delivery.

Implementing Webhook Handlers

1. Verify Signature: Always verify the webhook signature using the provided secret
2. Handle Idempotency: Webhooks may be sent multiple times for reliability
3. Process Asynchronously: Don't block the webhook response (respond quickly)
4. Log Events: Keep logs of all webhook events for debugging
5. Handle Errors: Implement proper error handling and return appropriate HTTP status codes
6. Use HTTPS: Ensure your webhook endpoint uses HTTPS (required for security)