Configuring Webhook Endpoints for Deployments

Deployment Webhooks

Boottify sends real-time webhook notifications for deployment events, allowing you to integrate with external services like Slack, Discord, or custom monitoring tools.

Supported Events

• deployment.started — A new deployment has begun
• deployment.step.completed — A deployment step finished (build, push, configure, deploy)
• deployment.succeeded — Deployment completed successfully
• deployment.failed — Deployment failed with error details
• deployment.rolled_back — Automatic rollback was triggered

Setting Up a Webhook

1. Go to Apps → Your App → Settings → Webhooks
2. Click Add Webhook Endpoint
3. Enter your endpoint URL (must be HTTPS)
4. Select the events you want to receive
5. Copy the signing secret for payload verification

Webhook Payload

Each webhook sends a JSON payload with the following structure:

{
  "event": "deployment.succeeded",
  "timestamp": "2026-02-15T10:30:00Z",
  "app": {
    "id": "app-abc123",
    "name": "my-app"
  },
  "deployment": {
    "id": "deploy-xyz789",
    "version": "v1.2.3",
    "duration": 45,
    "steps": [...]
  }
}

Verifying Webhook Signatures

All webhooks include an X-Boottify-Signature header. Verify it using HMAC-SHA256 with your signing secret to ensure the payload wasn't tampered with.

Retry Policy

Failed webhook deliveries are retried up to 3 times with exponential backoff (1 min, 5 min, 30 min). Endpoints that fail consistently are automatically disabled after 10 consecutive failures.