List Meeting Registrants
zoom.list_registrants
ActionChat & messagingconnection required
Calls the Zoom API with the connection's credentials.
Page through who has registered for a meeting, by approval status.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- OAuth 2.0
- Providers
- Zoom
- Secret shape
- {"account_id", "client_id", "client_secret"} — Server-to-Server OAuth
- Config it needs
- account_id
- Resolved by
- config.connection_id, else node.connection_id
Configuration
5 fields, 1 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.
| Field | Type | Required | Default | Constraints | Example |
|---|---|---|---|---|---|
meeting_id The meeting number, as a string — an int64 read as a number loses digits. The spaced form Zoom's UI shows ('812 3456 7890') is accepted. | string | Yes | — | — | 81234567890 |
status Which registrations to list. | string | No | approved | one of "approved", "pending", "denied" | — |
occurrence_id One occurrence of a recurring meeting. Leave blank to act on the series. | string | No | — | — | — |
page_size How many rows to return on this page (1-300). | number | No | 30 | 1–300 | — |
next_page_token The next_page_token from a previous page. Zoom expires it after 15 minutes. | string | No | — | — | — |
Example configuration
Every value below is the contract’s own example or default — nothing invented.
{
"meeting_id": "81234567890",
"page_size": 30,
"status": "approved"
}Output
One shape.
result
| Field | Type | Example |
|---|---|---|
registrants[].id The registrant id, used to approve or deny them. | string | — |
registrants[].email The registrant's email address. | string | — |
registrants[].first_name The registrant's first name. | string | — |
registrants[].last_name The registrant's last name. | string | — |
registrants[].status One of approved, pending or denied. | string | — |
registrants[].create_time When the registration was submitted. | string | — |
registrants[].join_url This registrant's personal join link. | string | — |
count How many rows this page carries. | number | — |
next_page_token Token for the next page, or empty when done. Expires after 15 minutes. | string | — |
total_records How many records Zoom reports across all pages. | number | — |
page_size The page size Zoom actually applied. | number | — |
{
"count": 0,
"next_page_token": "",
"page_size": 0,
"registrants": [
{
"create_time": "",
"email": "",
"first_name": "",
"id": "",
"join_url": "",
"last_name": "",
"status": ""
}
],
"total_records": 0
}Notes
- Zoom defaults status to 'approved', so a run that returns nothing usually means the registrations are still pending.
See List Meeting Registrants run in a workflow.
In a technical demo we add the Zoom connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.