Webhooks

Push real-time data to external systems when events happen in your workspace. Connect to CRMs, analytics platforms, Zapier, n8n, or any HTTP endpoint.

What Webhooks Do

Webhooks bridge Gravity Rail to your other tools:

• Sync data in real-time when events occur
• Trigger external workflows automatically
• Integrate with any API that accepts HTTP POST
• Monitor delivery with logging and retries
• Send structured JSON with full context

Key Features

Automatic Retries

Failed webhooks retry automatically with exponential backoff (up to 5 attempts, starting 10 seconds apart), then are logged as failed.

Delivery Logs

View all webhook executions with request/response details, status, and retry attempts.

Secure Delivery

HTTPS only. No localhost or internal IPs. Public DNS resolution required.

How It Works

Event Occurs    →    Event Rule Fires    →    HTTP POST Sent
(task, data)         (conditions met)         (to your endpoint)

Webhooks are configured as actions in Event Rules. When conditions are met, Gravity Rail sends a JSON payload to your URL.

Webhook Payload

Every payload carries a top-level event field naming the event type, plus eventRule and workspace blocks. The rest of the body varies by event family (data record, member, or call/chat). For example, a new data record:

{
  "event": "data_record:created",
  "dataType": { "uuid": "5f3c…", "type": "Contact Form", "slug": "contact_form" },
  "member": {
    "id": 123,
    "name": "John Doe",
    "email": "john@example.com",
    "labels": ["vip"]
  },
  "dataRecord": {
    "id": 4567,
    "fields": { "message": "Hello!", "priority": "high" }
  },
  "eventRule": { "id": 88, "uuid": "a1b2…", "name": "Notify CRM" },
  "workspace": { "uuid": "9e8d…", "name": "Acme Health" }
}

For the complete payload field reference (every event family), HMAC signature verification, and how to fetch call audio/transcript, see the Webhooks developer reference.

Common Integrations

Platform	Use Case
Zapier	Connect to 5000+ apps
n8n	Self-hosted automation
Slack	Team notifications
Custom API	Your own systems

Common Use Cases

Use Case	What It Does
CRM Sync	Push qualified leads to Salesforce
Analytics	Track funnel events in your platform
Notifications	Alert Slack when VIP contacts you
Data Export	Sync collected data to your database

Pricing & Limits

Feature availability and limits are determined by your subscription plan. See the pricing page for details.

Related Resources

• Event Rules - Configure webhook triggers
• Data Types - Data sent in webhooks
• Routines - Time-based webhooks