Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Zoom

Schemeszoom://
Cargo featureservice-zoom
Servicehttps://zoom.us/
Body formatstext (first is the default)
Attachmentsno
Title length250 characters
Body length3,750 characters
Body linesunlimited
Request throttlenone
Vendor URLs acceptedyes

URL formats

{schema}://{webhook_id}/{token}

{schema} is one of zoom://.

URL tokens

TokenMeaningTypeRequiredDefaultNotes
{token}Verification Tokenstringyessecret
{webhook_id}Webhook IDstringyessecret

Query parameters

ParameterMeaningTypeDefaultNotes
modeModechoicefullone of simple, full; simple sends ?format=message with plain text
tokenVerification Tokenstringsets {token}

The common URL parameters (format, overflow, verify, redirect, cto, rto, retry, wait, store, tag, tz, user, password, port, optional, emojis) apply as well.

Examples

Accepted URLs (tokens are fake):

zoom://abc123/xyz456
zoom://abc123/xyz456?mode=full
https://inbots.zoom.us/incoming/hook/abc123?token=xyz456
https://integrations.zoom.us/chat/webhooks/incomingwebhook/abc123?token=xyz456
zoom://myhookid/?token=override123
zoom://myhookid/mytoken/?token=override123
https://inbots.zoom.us/incoming/hook/abc-1_2/?token=xyz456&mode=simple

Rejected URLs:

zoom://abc123/xyz456?mode=invalid
https://inbots.zoom.us/incoming/hook/abc123
zoom://
zoom://:@/

Send one from the command line:

mercurio -t 'Backup' -b 'Finished in 42s' 'zoom://abc123/xyz456'

Notes

Zoom Team Chat incoming webhooks (zoom://).

POST https://integrations.zoom.us/chat/webhooks/incomingwebhook/{id} with the verification token in Authorization: either ?format=full with a JSON message card or ?format=message with the text as the body.

Differences with Apprise

  • Apprise posts to inbots.zoom.us/incoming/hook/{id}, while mercurio posts to the current integrations.zoom.us/chat/webhooks/incomingwebhook/{id} (?format=full; ?format=message for mode=simple); native URLs on either host are accepted.