Webhooks

Webhooks send selected meeting events as plaintext JSON. Use them only with endpoints your workspace trusts.

Create

Create webhooks in Desktop: Integrations -> Plaintext webhooks. Or use the SDK:

webhook = client.create_webhook(
    name="Meeting webhook",
    url="https://example.com/vued",
    events=["meeting.finalized"],
    payload_fields={"default": ["meeting", "timestamps", "title", "summary"]},
)
print(webhook["secret"])  # shown once

For meeting payloads, summary contains rendered markdown notes: the TLDR blockquote followed by topic sections. Limits: 5 webhooks per workspace. Delivery URLs must be HTTPS and cannot resolve to private, loopback, link-local, multicast, reserved, or metadata IPs. API keys need webhooks:read to list deliveries and webhooks:write to create, update, delete, or retry.

Events

Event	Fires when
`meeting.started`	Meeting starts.
`meeting.ended`	Meeting ends.
`meeting.transcription.completed`	First transcription completes.
`meeting.retranscription.completed`	Retranscription completes.
`meeting.speaker_id.completed`	Speaker identification completes.
`meeting.finalized`	Meeting is finalized.
`meeting.automatic.surfaced`	Automatic meeting is surfaced.

Payload

Every delivery has:

{
  "id": "evt_...",
  "object": "event",
  "type": "meeting.finalized",
  "created_at": "2026-06-30T12:00:00.000Z",
  "org_id": "org_uuid",
  "data": {
    "object": "meeting",
    "id": "meeting_uuid"
  }
}

Choose payload fields with payload_fields. Empty means all fields. Use default, *, or an event name as the map key.

Field	Includes
`meeting`	Meeting identity and metadata.
`timestamps`	Start, end, create, update times.
`room`	Room and microphone metadata.
`participants`	Meeting-level participant roster.
`speakers`	Diarized transcript speakers.
`audio_metadata`	Short-lived signed audio URL when available.
`transcript_text`	Full transcript text.
`transcript_events`	Ordered transcript events.
`summary`	Meeting markdown notes, starting with the TLDR when generated.
`topics`	Topic list.
`title`	Meeting title.

Verify

Deliveries include:

Header	Value
`Vued-Event-Id`	Event ID.
`Vued-Webhook-Id`	Webhook ID.
`Vued-Webhook-Timestamp`	Unix timestamp.
`Vued-Signature`	`t=<timestamp>,v1=<hex_hmac_sha256>`.

import hashlib
import hmac

timestamp = request.headers["Vued-Webhook-Timestamp"]
signature = request.headers["Vued-Signature"].split("v1=", 1)[1]
body = request.get_data()

expected = hmac.new(
    b"whsec_...",
    timestamp.encode() + b"." + body,
    hashlib.sha256,
).hexdigest()

ok = hmac.compare_digest(signature, expected)

Delivery

A delivery succeeds on any HTTP 2xx. Redirects are not followed. Timeout is 8 seconds. Failures retry with exponential backoff for up to 8 attempts or until the encrypted retry payload expires after 24 hours. Delivery states are pending, delivering, succeeded, and terminal failed. Use GET /orgs/{org_id}/webhooks/{webhook_id}/deliveries to inspect the last 100 attempts. Pending deliveries can be retried from Desktop or with POST /orgs/{org_id}/webhooks/{webhook_id}/deliveries/{delivery_id}/trigger.

Get Started

MCP

Headless CLI

Docs Ops

API Reference

Webhooks

Create

Events

Payload

Verify

Delivery

​Create

​Events

​Payload

​Verify

​Delivery

Create

Events

Payload

Verify

Delivery