At a glance
- Availability: Experimental (how to enable).
- 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
Credentials
Set these per environment. See Connect an integration. With a managed OAuth app, Connect works without these variables; set them to use your own OAuth app instead.Setup
- Create a Webex integration: Sign in at https://developer.webex.com/ (a free Webex account works) and go to My Apps → Create a New App → Create an Integration.
- 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.
- 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).
- 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
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.