Configuring Webhooks
Webhooks allow you to receive real-time HTTP notifications when events occur on your Boottify platform. Use them to integrate with external services, trigger automation, or log events.
Creating a Webhook
- Navigate to Admin → Webhooks.
- Click New Webhook.
- Configure the webhook:
- Name — A descriptive name for the webhook.
- URL — The endpoint URL that will receive the webhook payload.
- Secret — A shared secret for verifying webhook signatures.
- Events — Select which events trigger this webhook.
- Active — Toggle to enable or disable the webhook.
Available Events
Webhooks can be triggered by:
- Deployment Events — deployment.started, deployment.completed, deployment.failed
- User Events — user.created, user.updated, user.deleted
- Billing Events — payment.succeeded, payment.failed, subscription.changed
- Application Events — app.created, app.updated, app.deleted
Testing Webhooks
Before relying on a webhook in production:
- Open the webhook detail page.
- Click Send Test.
- A sample payload is sent to your endpoint.
- Verify that your endpoint responds with a
200 OKstatus.
Webhook Payload
Each webhook delivery includes:
- Headers — Content type, webhook signature, and delivery ID.
- Body — JSON payload with event type, timestamp, and event data.
{
"event": "deployment.completed",
"timestamp": "2026-02-09T12:00:00Z",
"data": {
"applicationId": "...",
"status": "success"
}
}
Managing Webhooks
- Edit webhook configuration at any time.
- Disable webhooks temporarily without deleting them.
- View delivery history and retry failed deliveries.
- Delete webhooks that are no longer needed.