Webhooks

Register your webhook endpoint to receive notifications when subscription events occur. You'll need to register a separate endpoint for each event type you want to receive.

How to register multiple event types: If you want to receive multiple event types (e.g., both subscription.created and subscription.updated), make separate registration requests—one for each event type. You can use the same URL for multiple event types if your endpoint handles multiple event types.

What happens after registration: Once registered, Bundled will automatically send POST requests to your endpoint whenever the specified event occurs. We'll use Basic Authentication with the username and password you provide during registration.

Webhook payloads: The payload format depends on which event type you're receiving:

• subscription.created: See SubscriptionCreatedPayload schema
• subscription.updated: See SubscriptionUpdatedPayload schema
• subscription.cancelled: See SubscriptionCancelledPayload schema
• subscription.renewed: See SubscriptionRenewedPayload schema

What your endpoint should do:

• Accept POST requests with Content-Type: application/json
• Authenticate requests using Basic Auth (we'll use the credentials you provided)
• Return 200 OK to acknowledge successful receipt
• Process the webhook payload to provision or update customer access

Testing your integration: Once registered, use the Simulate a webhook event endpoint to send test events to your webhook URL.

Test this webhook: Use this endpoint to simulate webhook events with sample data. Send a test event to your registered endpoint for any event type (subscription.created, subscription.updated, subscription.cancelled, subscription.renewed).

Queue a test webhook event with sample data. This uses the same delivery mechanism as production webhooks, so you can test your endpoint with realistic data. The webhook will be sent to your registered endpoint URL via the same cron-based delivery system used in production.