OpenAPI 3.1.0raw.githubusercontent.com2026-08-191,3412,1385.0 MB

ec31f78cf002

Meeting Session Webhooks

session.status_changed

Sent when the session moves to a new lifecycle status. Deliveries are best effort and not guaranteed: up to 5 attempts with backoff that starts around 60 seconds and roughly doubles per retry, and a 10-second delivery timeout, so respond with a 2xx promptly. Retries can produce duplicates; deduplicate on envelope id.

postWebhooksessionStatusChanged

Headers

X-Meeting-Bot-Signaturestring required

Signature header t=<unix-seconds>,v1=<hex>. Compute HMAC-SHA256 with the webhook secret over the timestamp ASCII bytes, a literal . byte, and the exact raw request-body bytes; hex-encode and compare v1 in constant time. Reject timestamps outside your accepted skew. No bearer token is sent.

Payload

event'session.status_changed' required

Event type.

idstring required

Unique event id; deduplicate deliveries on it.

occurred_atstring date-time required

When the event occurred.

versionstring required

Envelope version.

Example payload

{
  "data": {
    "session_id": "mtgsess_9b2f..."
  },
  "id": "whdel_9f2c...",
  "version": "1"
}

Response

Return any 2xx status promptly to acknowledge the delivery; non-2xx responses and timeouts are retried.