Webhook payloads

Sample payloads and headers sent by Distro Workflows webhooks.

Sample webhook payloads for different sources in Distro Workflows.

Distro sends JSON by HTTP POST to your configured webhook URL.

Payload shape depends on the source type and trigger.

Payloads are examples. Distro may add fields over time.

Basics

All webhooks use the same envelope:

{
  "event": "meeting_booked",
  "timestamp": "2024-01-15T10:30:00Z",
  "data": {}
}

• event: the trigger that fired the webhook (see Workflows).

• timestamp: ISO 8601 time when Distro built the payload. Retries reuse the payload.

• data: the event payload. Shape depends on source type.

Conventions:

• Keys use snake_case.

• data.source_type is one of: router, click_router, booking_link, group_meeting_link, outbound_router.

• Submission-only triggers include submission and assignee; they omit booking and attendees. Meeting triggers include booking, assignee, and attendees; they omit submission.

Meeting details

Booking payloads also include location, in_person, and event_type. For an in-person meeting, use location as the meeting address; do not expect a conferencing URL. event_type, when present, contains id, title, and availability_mode.

For an Outbound Router, source_type is outbound_router, source_id identifies the router, and source_title contains its name. The booking envelope is the same as other meeting sources. Outbound attendees also include their role.

Payload examples

Router

Triggered by Form Routers.

{
  "event": "meeting_booked",
  "timestamp": "2024-01-15T10:30:00Z",
  "data": {
    "source_type": "router",
    "source_id": 123,
    "source_title": "Demo Request Router",
    "booking": {
      "id": 456,
      "uuid": "book-abc123-def456",
      "title": "Discovery Call with Acme Corp",
      "start_time": "2024-01-20T14:00:00Z",
      "end_time": "2024-01-20T14:30:00Z",
      "status": "scheduled",
      "meeting_url": "https://meet.google.com/abc-defg-hij",
      "time_zone": "America/New_York",
      "notes": "Looking forward to discussing your needs.",
      "location": null,
      "in_person": false,
      "event_type": {
        "id": 12,
        "title": "Discovery",
        "availability_mode": "default"
      }
    },
    "assignee": {
      "id": 1,
      "email": "[e-mail]",
      "first_name": "Alex",
      "last_name": "Smith"
    },
    "attendees": [
      {
        "name": "Jane Doe",
        "email": "[e-mail]"
      }
    ]
  }
}

Submission-only events

For form_submitted, prospect_disqualified, and prospect_no_booking, the payload includes submission details and omits booking details. If no host was assigned, assignee is an empty object.

{
  "event": "form_submitted",
  "timestamp": "2024-01-15T10:30:00Z",
  "data": {
    "source_type": "router",
    "source_id": 123,
    "source_title": "Contact Form Router",
    "submission": {
      "id": 789,
      "uuid": "sub-xyz789-abc123",
      "form_data": {
        "email": "[e-mail]",
        "company": "Acme Corp",
        "employees": "50-100"
      },
      "time_zone": "America/New_York",
      "source_url": "https://example.com/contact",
      "created_at": "2024-01-15T10:30:00Z"
    },
    "assignee": {
      "id": 1,
      "email": "[e-mail]",
      "first_name": "Alex",
      "last_name": "Smith"
    }
  }
}

Click Router

Triggered by Click Routers.

{
  "event": "meeting_booked",
  "timestamp": "2024-01-15T10:30:00Z",
  "data": {
    "source_type": "click_router",
    "source_id": 456,
    "source_title": "Sales Team Round Robin",
    "booking": {
      "id": 789,
      "uuid": "book-def456-ghi789",
      "title": "Sales Call",
      "start_time": "2024-01-22T15:00:00Z",
      "end_time": "2024-01-22T15:30:00Z",
      "status": "scheduled",
      "meeting_url": "https://zoom.us/j/123456789",
      "time_zone": "America/Los_Angeles",
      "notes": null,
      "location": null,
      "in_person": false,
      "event_type": {
        "id": 12,
        "title": "Discovery",
        "availability_mode": "default"
      }
    },
    "assignee": {
      "id": 5,
      "email": "[e-mail]",
      "first_name": "Sarah",
      "last_name": "Johnson"
    },
    "attendees": [
      {
        "name": "John Smith",
        "email": "[e-mail]"
      }
    ]
  }
}

Booking Link

Triggered by Personal Booking Links.

{
  "event": "meeting_booked",
  "timestamp": "2024-01-15T10:30:00Z",
  "data": {
    "source_type": "booking_link",
    "source_id": 101,
    "source_slug": "alex-30min",
    "booking": {
      "id": 1001,
      "uuid": "book-jkl012-mno345",
      "title": "30-min Meeting with Alex",
      "start_time": "2024-01-25T09:00:00Z",
      "end_time": "2024-01-25T09:30:00Z",
      "status": "scheduled",
      "meeting_url": "https://meet.google.com/xyz-abcd-efg",
      "time_zone": "Europe/London",
      "notes": "Want to discuss partnership opportunities",
      "location": null,
      "in_person": false,
      "event_type": {
        "id": 12,
        "title": "Discovery",
        "availability_mode": "default"
      }
    },
    "assignee": {
      "id": 1,
      "email": "[e-mail]",
      "first_name": "Alex",
      "last_name": "Smith"
    },
    "attendees": [
      {
        "name": "Emily Chen",
        "email": "[e-mail]"
      }
    ]
  }
}

Group Meeting Link

Triggered by Group Meeting Links.

{
  "event": "meeting_booked",
  "timestamp": "2024-01-15T10:30:00Z",
  "data": {
    "source_type": "group_meeting_link",
    "source_id": 202,
    "source_slug": "sales-engineering-demo",
    "booking": {
      "id": 2001,
      "uuid": "book-pqr678-stu901",
      "title": "Sales + Engineering Demo",
      "start_time": "2024-01-28T16:00:00Z",
      "end_time": "2024-01-28T17:00:00Z",
      "status": "scheduled",
      "meeting_url": "https://teams.microsoft.com/l/meetup-join/...",
      "time_zone": "America/Chicago",
      "notes": "Technical deep-dive requested",
      "location": null,
      "in_person": false,
      "event_type": {
        "id": 12,
        "title": "Discovery",
        "availability_mode": "default"
      }
    },
    "assignee": {
      "id": 3,
      "email": "[e-mail]",
      "first_name": "Mike",
      "last_name": "Wilson"
    },
    "attendees": [
      {
        "name": "David Brown",
        "email": "[e-mail]"
      }
    ]
  }
}

Operational notes

HTTP headers and signatures

Production deliveries include these headers by default:

• Content-Type: application/json

• User-Agent: Distro-Webhooks/1.0

• X-Distro-Delivery-ID: unique delivery ID for tracking

• X-Distro-Timestamp: Unix timestamp of request (seconds)

• X-Distro-Signature: t={timestamp},v1={signature} (only if a signing secret is configured)

Test webhooks include X-Distro-Test: true and may omit X-Distro-Delivery-ID. Custom headers can override defaults; avoid reusing the Distro header names.

Use X-Distro-Delivery-ID as an idempotency key if you store deliveries. Return a successful HTTP response after accepting the request. Failed production deliveries can be retried, up to six attempts. Review workflow history when delivery fails.

Verifying signatures

• Signature header: X-Distro-Signature: t={timestamp},v1={signature}

• Signed content: {timestamp}.{raw_request_body}

• Algorithm: HMAC-SHA256 using your signing secret

• Compare the computed hex digest with v1

Use the raw request body bytes for verification.

Don’t parse and re-serialize JSON before hashing.

Event-specific notes

Cancelled meetings

When event is meeting_cancelled, booking.status is cancelled.

{
  "event": "meeting_cancelled",
  "timestamp": "2024-01-18T11:00:00Z",
  "data": {
    "booking": {
      "status": "cancelled"
    }
  }
}

No-show meetings

When event is meeting_no_show, booking.status is no_show.

{
  "event": "meeting_no_show",
  "timestamp": "2024-01-18T11:00:00Z",
  "data": {
    "booking": {
      "status": "no_show"
    }
  }
}

Payload limits

• Maximum payload size: 1 MB

• Maximum form_data size: 100 KB

If limits are exceeded, Distro truncates data and includes a truncation marker:

{
  "form_data": {
    "_truncated": true,
    "_original_size": 150000,
    "_message": "Form data exceeded 102400 bytes and was truncated"
  }
}