> ## Documentation Index
> Fetch the complete documentation index at: https://explore.airia.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Zoom

> Schedule and manage Zoom meetings and look up users from inside an agent workflow.

Zoom actions let an agent work with meetings and users directly in a flow. An agent can create, update, read, list, and delete meetings, and look up users, then pass the results to later steps.

## Supported actions

| Group       | Actions                              |
| ----------- | ------------------------------------ |
| **Meeting** | Create, Update, Get, Get All, Delete |
| **User**    | Get, Get All                         |

## Prerequisites

<AccordionGroup>
  <Accordion title="Create a Zoom credential" icon="key">
    Connect a **Zoom OAuth** credential, stored as a Zoom credential, in [Credential Management](/admin-hub/account_settings/credential-management), then select it on every Zoom action.
  </Accordion>
</AccordionGroup>

## How to use these actions

* **Map text inputs from earlier steps.** Inputs such as **Topic**, **Agenda**, and **Meeting ID** accept a value mapped from a previous step.
* **Numbers and toggles take fixed values.** The meeting **Type**, **Duration**, **Page Size**, and **Page Number** numbers and the **Notify Registrants** toggle are entered directly rather than mapped from a previous step.
* **Use `me` for the authenticated user.** Where an input expects a user, pass `me` to act as the connected account.
* **Scheduled meetings need a Start Time.** A scheduled meeting requires a **Start Time** value.
* **Dates use ISO 8601 format.** Date and time inputs such as **Start Time** use ISO 8601 format.

## Actions

### Meeting

#### Zoom Meeting Create

Creates a new meeting.

| Input          | Required    | Description                                                                                                                                       |
| -------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Topic**      | Yes         | The meeting title.                                                                                                                                |
| **Type**       | No          | The meeting type, a fixed number. `1` instant, `2` scheduled, `3` recurring with no fixed time, `8` recurring with a fixed time. Defaults to `2`. |
| **Start Time** | Conditional | The meeting start in ISO 8601 format. Required for scheduled meetings.                                                                            |
| **Duration**   | No          | The meeting length in minutes, from 1 to 1440. Defaults to 60.                                                                                    |
| **Timezone**   | No          | The meeting time zone, such as `America/New_York`. Defaults to UTC.                                                                               |
| **Password**   | No          | The meeting passcode. Zoom may generate one if omitted.                                                                                           |
| **Agenda**     | No          | The meeting description.                                                                                                                          |
| **User ID**    | No          | The user to schedule the meeting for. Defaults to `me`.                                                                                           |

#### Zoom Meeting Update

Updates an existing meeting.

| Input          | Required | Description                                        |
| -------------- | -------- | -------------------------------------------------- |
| **Meeting ID** | Yes      | The unique identifier of the meeting to update.    |
| **Topic**      | No       | The new meeting title.                             |
| **Start Time** | No       | The new meeting start in ISO 8601 format.          |
| **Duration**   | No       | The new meeting length in minutes, from 1 to 1440. |
| **Timezone**   | No       | The meeting time zone, such as `America/New_York`. |
| **Password**   | No       | The meeting passcode.                              |
| **Agenda**     | No       | The new meeting description.                       |

#### Zoom Meeting Get

Retrieves a single meeting.

| Input          | Required | Description                                       |
| -------------- | -------- | ------------------------------------------------- |
| **Meeting ID** | Yes      | The unique identifier of the meeting to retrieve. |

#### Zoom Meeting Get All

Lists meetings for a user.

| Input           | Required | Description                                                                                                |
| --------------- | -------- | ---------------------------------------------------------------------------------------------------------- |
| **User ID**     | No       | The user whose meetings to list. Defaults to `me`.                                                         |
| **Type**        | No       | The meeting category, one of `scheduled`, `live`, `upcoming`, `upcoming_meetings`, or `previous_meetings`. |
| **Page Size**   | No       | Number of meetings per page, from 1 to 300. Defaults to 30.                                                |
| **Page Number** | No       | The page of results to return. Defaults to 1.                                                              |

#### Zoom Meeting Delete

Deletes a meeting.

| Input                  | Required | Description                                                                   |
| ---------------------- | -------- | ----------------------------------------------------------------------------- |
| **Meeting ID**         | Yes      | The unique identifier of the meeting to delete.                               |
| **Notify Registrants** | No       | Whether to send a cancellation email to registrants. Toggle, defaults to off. |

### User

#### Zoom User Get

Retrieves a single user.

| Input       | Required | Description                                                                        |
| ----------- | -------- | ---------------------------------------------------------------------------------- |
| **User ID** | No       | A user ID or email address. Use `me` for the authenticated user. Defaults to `me`. |

#### Zoom User Get All

Lists users in the account.

| Input           | Required | Description                                                                 |
| --------------- | -------- | --------------------------------------------------------------------------- |
| **Status**      | No       | The account status to filter by, one of `active`, `inactive`, or `pending`. |
| **Page Size**   | No       | Number of users per page, from 1 to 300. Defaults to 30.                    |
| **Page Number** | No       | The page of results to return. Defaults to 1.                               |

## Example

An agent that schedules a Zoom meeting for a requester:

<Steps>
  <Step title="Look up the host">
    A **Zoom User Get** action with **User ID** set to the requester's email confirms the host account.
  </Step>

  <Step title="Create the meeting">
    A **Zoom Meeting Create** action sets **Topic** to the meeting title, **Type** to `2`, maps **Start Time** to the requested slot in ISO 8601 format, and sets **Duration** to 30.
  </Step>

  <Step title="Confirm">
    A model step summarizes the created meeting, including the returned meeting ID and join link, for the activity log.
  </Step>
</Steps>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Start Time is required" icon="clock">
    A scheduled meeting (**Type** `2`) needs a **Start Time** in ISO 8601 format. Provide a start time or use an instant meeting (**Type** `1`).
  </Accordion>

  <Accordion title="Meeting or user not found" icon="circle-question">
    The **Meeting ID** or **User ID** does not exist or the connected account cannot see it. Confirm the meeting belongs to the authenticated user and use `me` for the connected account.
  </Accordion>

  <Accordion title="Authentication failed" icon="lock">
    The Zoom OAuth credential expired or was revoked. Reconnect the credential and confirm the Zoom app grants meeting and user scopes.
  </Accordion>
</AccordionGroup>

For issues common to every vendor, see the [Actions overview](/building-and-deploying-agents/agent-basics/actions/overview#troubleshooting).
