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

# Webex

> Send messages and look up rooms and people in Webex

## At a glance

* **Availability**: Experimental ([how to enable](/cloud/integrations)).
* **Auth**: OAuth 2.0.
* **Connection**: A user authorizes the connection in the provider's consent screen.
* **Scopes**: `spark:messages_read`, `spark:messages_write`, `spark:rooms_read`, `spark:people_read`.
* **Docs**: [https://developer.webex.com/docs/integrations](https://developer.webex.com/docs/integrations)

## Credentials

Set these per environment. See [Connect an integration](/cloud/integrations).

With a managed OAuth app, Connect works without these variables; set them to use your own OAuth app instead.

| Variable              | Required | Description                                                                                                           |
| --------------------- | -------- | --------------------------------------------------------------------------------------------------------------------- |
| `WEBEX_CLIENT_ID`     | Yes      | Webex Integration Client ID (from your integration in My Apps) [Docs](https://developer.webex.com/docs/integrations). |
| `WEBEX_CLIENT_SECRET` | Yes      | Webex Integration Client Secret [Docs](https://developer.webex.com/docs/integrations).                                |

## Setup

1. **Create a Webex integration**: Sign in at [https://developer.webex.com/](https://developer.webex.com/) (a free Webex account works) and go to My Apps → Create a New App → Create an Integration.
2. **Set the redirect URI and scopes**: Set the Redirect URI to your app URL ending in /api/auth/webex/callback and select the scopes spark:messages\_read, spark:messages\_write, spark:rooms\_read, and spark:people\_read.
3. **Copy credentials**: Copy the integration's Client ID and Client Secret into WEBEX\_CLIENT\_ID and WEBEX\_CLIENT\_SECRET (the secret is shown only once).
4. **Verify access**: Connect your Webex account and run the Get My Details tool.

* The token endpoint takes client\_id and client\_secret in the POST body
* Access tokens last 14 days; refresh tokens last 90 days and their lifetime renews on each refresh
* Webex automatically adds the spark:kms scope so the integration can read encrypted message content

Provider API reference: [https://developer.webex.com/docs/api/getting-started](https://developer.webex.com/docs/api/getting-started)

## Tools

| Tool           | Access | Description                                                 |
| -------------- | ------ | ----------------------------------------------------------- |
| List Rooms     | Read   | List Webex rooms (spaces) the authenticated user belongs to |
| List Messages  | Read   | List recent messages in a Webex room                        |
| Send Message   | Write  | Send a message to a Webex room or directly to a person      |
| Get My Details | Read   | Get the authenticated Webex user's profile                  |
| List People    | Read   | Look up people in the organization by email or display name |

## Example prompts

* List the most recent messages in one of my Webex rooms and summarize the discussion.
* Send a Webex message to a room or a person.