Skip to main content

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. A 4xx response is treated as a permanent rejection and is not retried.

Every Event Type Documented​

Webhooks can fire on form submissions, member changes, chats, messages, workflow and task lifecycle, calendar bookings, journey enrolment, voice calls, voicemails, and inbound faxes. The complete event catalog lists every trigger with the exact payload it delivers.

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 eventId, eventRule, and workspace. The rest of the body takes one of five shapes depending on the event family — data record, member, voicemail, fax, or the lean shape every other event uses. 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 per-event catalog, the complete payload field reference for every family, HMAC signature verification, the delivery and retry contract, how to fetch call audio/transcript, and how to send events into Gravity Rail, see the Webhooks developer reference.

Common Integrations​

PlatformUse Case
ZapierConnect to 5000+ apps
n8nSelf-hosted automation
SlackTeam notifications
Custom APIYour own systems

Common Use Cases​

Use CaseWhat It Does
CRM SyncPush qualified leads to Salesforce
AnalyticsTrack funnel events in your platform
NotificationsAlert Slack when VIP contacts you
Data ExportSync collected data to your database

Pricing & Limits​

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