Webex

{/* Generated by scripts/generate-integration-catalog.mjs. Do not edit by hand. */}

At a glance

  • Availability: Experimental (how to enable).
  • Authentication: 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.
  • Provider documentation: Authentication reference.

Credentials

Set these per environment. See Connect an integration.

These variables are required only when you supply your own OAuth app. If a managed app is available, you can connect without setting them. Provider permissions and consent still apply.

VariableRequiredDescription
WEBEX_CLIENT_IDYesWebex Integration Client ID (from your integration in My Apps) Docs.
WEBEX_CLIENT_SECRETYesWebex Integration Client Secret Docs.

Setup

  1. 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.
  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.

Provider notes

  • 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.

Tools

ToolAccessDescription
List Rooms<br /><code className="reference-identifier">webex__list_rooms</code>ReadList rooms
List Messages<br /><code className="reference-identifier">webex__list_messages</code>ReadList messages
Send Message<br /><code className="reference-identifier">webex__create_message</code>WriteSend message
Get My Details<br /><code className="reference-identifier">webex__get_my_details</code>ReadGet my details
List People<br /><code className="reference-identifier">webex__list_people</code>ReadFind people by email or name

Verify the connection

Call a read tool such as webex__list_rooms with arguments for your account. Confirm that the result comes from the intended account or workspace before enabling write tools.