Webhooks

Pro

Send form submission data to any URL in real-time. Perfect for custom backends, internal tools, or services without native integrations.

What are Webhooks?

Webhooks are HTTP callbacks that send data to your server when an event occurs. When someone submits your form, Orbit AI sends a POST request to your specified URL with the submission data in JSON format.

Real-time

Data sent instantly on submission

Flexible

Any endpoint that accepts HTTP

Secure

HMAC signature verification

Retries

Automatic retry on failure

Setting Up a Webhook

1Open your form and navigate to the Workflows tab
2Add a new workflow or edit an existing one
3Add a "Webhook" destination node
4Enter your endpoint URL (must be HTTPS)
5Configure headers and authentication if needed
6Map form fields to your payload structure
7Test with a sample submission

Payload Format

Webhook payloads are sent as JSON with a standard structure. Here's an example:

JSON Payload

{
  "event": "form.submission",
  "timestamp": "2024-01-15T10:30:00Z",
  "form_id": "abc123",
  "form_name": "Contact Form",
  "submission_id": "sub_xyz789",
  "data": {
    "email": "user@example.com",
    "name": "John Doe",
    "message": "Hello, I'd like to learn more..."
  }
}

Security & Verification

Each webhook request includes a signature header for verification. Use this to ensure requests are genuinely from Orbit AI.

Signature Header

The X-Orbit-Signature header contains an HMAC-SHA256 hash of the request body.

Verification Steps

Get the raw request body
Compute HMAC-SHA256 using your webhook secret
Compare with the signature in the header
Reject requests with mismatched signatures

Error Handling & Retries

Success Response

Return a 2xx status code to confirm receipt. The response body is not processed.

Automatic Retries

Failed requests (5xx or timeout) are retried up to 3 times with exponential backoff.

Timeout

Requests timeout after 30 seconds. Ensure your endpoint responds quickly.

Next Steps

Integrations

Native app connections

API Reference

REST endpoints & examples

Did this answer your question?