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

# Webex

> Webex lets you manage meetings, rooms, teams, messages, and people via your connected account.

Use Webex when your workflow needs to create or update teams and rooms, send messages, or look up people and memberships. It fits steps that need collaboration data from your connected account.

## Configuration

| Option | Required | Description |
| - | - | - |
| Name | No | Label for the step in the workflow canvas. |
| Authentication | Yes | The connected Webex account to use for this step. |
| Action | Yes | The Webex action to perform (for example Get Team Details, List Teams, Create Room, Get Room Details). |
| Arguments | Yes | Per-action form fields generated from the action's schema. Each text field has an **Insert Variable** button for injecting `{{placeholder}}` values. A **Raw JSON** tab is available for advanced usage. |
| When the step fails | No | Controls whether the workflow should **Terminate Workflow** or **Continue** if this step fails. |

Before you configure this step, connect Webex in **Integrations** for your workspace using the sign-in flow. If no active connection is available, the step shows a warning with a link to **Integrations** instead of the account selector.

## Arguments form

When you select an action, the **Arguments** section renders a form driven by the action's input schema. Fields that refer to existing records include dropdown pickers.

Switch to the **Raw JSON** tab when you prefer to write the full arguments object by hand. Changes in either tab stay in sync.

## Common actions

| Action | Description |
| - | - |
| **Get Team Details** | Retrieves details for a specific team. |
| **List Teams** | Lists the teams the authenticated user belongs to. |
| **Create Room** | Creates a new Webex room for collaboration. |
| **Get Room Details** | Retrieves details for a specific room. |
| **List Rooms** | Lists the rooms the authenticated user belongs to. |
| **Update Room** | Updates a room's title, lock status, or team association. |
| **Create Message** | Posts a message to a Webex room or person. |
| **Get Message Details** | Retrieves details for a specific message. |
| **List Messages** | Lists messages in a room. |
| **Get Person Details** | Retrieves detailed profile information for a specific person. |
| **List People** | Lists people in your organization. |
| **List Memberships** | Lists memberships in Webex rooms. |
| **Get Membership Details** | Retrieves details for a specific room membership. |

Destructive actions, such as deleting records, are not available in the workflow action picker.

## Output

This step stores the Webex response as the step output. The shape of the response depends on the action.

Use the full output reference in later steps:

```text theme={null}
{{STEP_IDENTIFIER.output}}
```

## Example

1. Open **Integrations** and connect Webex if you have not already done that.
2. Add a **Webex** step to your workflow.
3. Select a connected account in **Authentication**.
4. Choose **Get Team Details** in **Action**.
5. Fill in the required fields. Use **Insert Variable** to reference an earlier step's output for any field value.
6. Click **Run** in the step header to test the action, then review the returned payload in **Output**.

## Use cases

### Create a team and room

1. Create Team
2. Create Room
3. Create Message

### Review room activity

1. List Rooms
2. Get Room Details
3. List Messages

### Find a person

1. List People
2. Get Person Details

## Notes

* This step depends on a connected Webex integration in your workspace.
* The workflow action picker shows a curated set of actions. Agents with the Webex tool can use more of them.
* The sign-in screen may show third-party authorization branding.

## Using Webex as an Agent Tool

You can also add Webex as a tool in the **Agent Editor**. Open the agent, click **Add tool**, and select **Webex**. In the tool settings panel, choose the connected account the agent should use. The agent calls Webex actions when they are relevant to the conversation.

See also: [Integrations](https://docs.fetchhive.com/workspace/integrations.md), [Creating and Editing](https://docs.fetchhive.com/workflows/creating-and-editing.md), and [Testing and Iteration](https://docs.fetchhive.com/workflows/testing-and-iteration.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.