Webhooks

Receive HTTP notifications when deploys and service events happen in your workspace.

Available Events

Event
deploy.started	deploy.succeeded
deploy.failed	service.created
service.deleted	service.updated
service.suspended	service.resumed

Security

• Optionally provide a secret -- RailPush signs every payload with HMAC-SHA256
• Verify via the X-RailPush-Signature header: sha256=<hex>
• The X-RailPush-Event header contains the event name
• All deliveries are logged -- check delivery history in the dashboard or API

API

# Create a webhook
curl -X POST https://railpush.com/api/v1/user-webhooks \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-app.com/webhook",
    "secret": "whsec_your_secret_here",
    "events": ["deploy.succeeded", "deploy.failed"]
  }'

# List webhooks
curl https://railpush.com/api/v1/user-webhooks \
  -H "Authorization: Bearer <token>"

# View delivery history
curl https://railpush.com/api/v1/user-webhooks/<id>/deliveries \
  -H "Authorization: Bearer <token>"

Payload Example

{
  "event": "deploy.succeeded",
  "timestamp": "2026-03-07T14:30:00Z",
  "data": {
    "service_id": "abc-123",
    "service_name": "my-api",
    "deploy_id": "def-456",
    "status": "success",
    "commit_sha": "a1b2c3d",
    "branch": "main",
    "duration_ms": 45200
  }
}