Webhooks & Integrations

Push events to external URLs with HMAC-signed payloads. Plus built-in integrations for Slack, Discord, email relays, and payment gateways.

Create a Webhook

POST /projects/{project_id}/integrations/webhooks

{
  "name": "Order Notifications",
  "url": "https://your-server.com/webhooks/orders",
  "events": ["table.orders.INSERT", "table.orders.UPDATE"],
  "is_active": true
}

// Response includes auto-generated signing secret
{
  "id": "uuid",
  "secret": "whsec_abc123...",
  "url": "https://your-server.com/webhooks/orders"
}

Webhook Payload

// Delivered to your URL with headers:
// X-Webhook-Secret: whsec_abc123...

{
  "event": "table.orders.INSERT",
  "project_id": "project-uuid",
  "timestamp": "2026-03-24T12:00:00Z",
  "data": {
    "id": "order-uuid",
    "amount": 1500,
    "status": "pending"
  }
}

Webhook Endpoints

Method	Path	Description
GET	/webhooks	List webhooks
POST	/webhooks	Create webhook
PUT	/webhooks/{id}	Update webhook
DELETE	/webhooks/{id}	Delete webhook
GET	/webhooks/{id}/deliveries	View delivery history
POST	/webhooks/{id}/test	Send test payload

Integrations

Pre-built connectors for popular services:

Provider	Category	Description
Slack	Messaging	Send notifications to Slack channels
Discord	Messaging	Post updates to Discord webhooks
Email Relay	Email	Forward events via email
Razorpay	Payments	Indian payments gateway
Cashfree	Payments	Indian payments gateway
PayU	Payments	Indian payments gateway

Configure Integration

// List available providers
GET /projects/{project_id}/integrations/providers

// Configure a provider
PUT /projects/{project_id}/integrations/providers/slack
{
  "config": { "webhook_url": "https://hooks.slack.com/services/..." },
  "is_active": true
}

// Delete integration
DELETE /projects/{project_id}/integrations/providers/slack

// Toggle on/off
POST /projects/{project_id}/integrations/providers/slack/toggle

Available Events

GET /projects/{project_id}/integrations/events

Returns the full list of subscribable events.