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

# Webex

## What's Supported

### Supported Actions

This connector supports:

* [Read Actions](/read-actions), including full historical backfill and incremental read.
* [Write Actions](/write-actions), including create and update operations.
* [Proxy Actions](/proxy-actions), using the base URL `https://webexapis.com`.

### Supported Objects

The Webex connector supports the following objects from the API:

* [people](https://developer.webex.com/docs/api/v1/people/list-people) (Read, Write)
* [groups](https://developer.webex.com/admin/docs/api/v1/groups) (Read, Write)
* [roles](https://developer.webex.com/docs/api/v1/roles/list-roles) (Read only)
* [events](https://developer.webex.com/docs/api/v1/events/list-events) (Read only)
* [organizations](https://developer.webex.com/docs/api/v1/organizations/list-organizations) (Read only)
* [reports](https://developer.webex.com/admin/docs/api/v1/reports/list-reports) (Read only)
* [meetings](https://developer.webex.com/meeting/docs/meetings) (Read, Write)

## Before you get started

To integrate Webex with Ampersand, you will need [a Cisco Webex Account](https://www.webex.com/signup).

Once your account is created, you'll need to create an integration in Webex and obtain the following credentials from your integration:

* Client ID
* Client Secret

You will then use these credentials to connect your application to Ampersand.

### Creating a Webex Integration

<Note>
  The Admin API is a superset of user-level APIs. Some objects (such as events,
  organizations, and reports) require organization-level admin scopes, while
  others (such as meetings) can be accessed with user-level scopes. Refer to the
  [Webex API documentation](https://developer.webex.com) to determine which
  account type and scopes are required for your use case.
</Note>

Follow the steps below to create a Cisco Webex integration and add the Ampersand redirect URL to the integration:

1. Log in to your [Webex Developer Portal](https://developer.webex.com/) account.

2. Click **My Apps** in the top navigation.

3. Click **Create a New App**.

4. Select **Integration** as the app type.

5. Enter your **App Name**.

6. Enter a **Description** for your integration.

7. Enter Ampersand's **Redirect URI**: `https://api.withampersand.com/callbacks/v1/oauth`.

8. Under **Scopes**, select the necessary [Scopes](https://developer.webex.com/create/docs/integrations#scopes) for your integration.

9. Click **Add Integration**.

<img src="https://mintcdn.com/ampersand-24eb5c1a/piRyHxCS64r1GVsK/images/provider-guides/webex.gif?s=e3f5adfe014cf3aef9878b1909db38fa" alt="Alt text" width="800" height="450" data-path="images/provider-guides/webex.gif" />

On the next screen, you'll see a **Client ID** and **Client Secret** have been generated.

You'll use these credentials while connecting your app to Ampersand.

## Add Your Webex App Info to Ampersand

1. Log in to your [Ampersand Dashboard](https://dashboard.withampersand.com).

2. Select the project where you want to create a Webex integration.

<img src="https://mintcdn.com/ampersand-24eb5c1a/Bx3tggG51e0liOp-/images/provider-guides/31a6a12-Ampersand.png?fit=max&auto=format&n=Bx3tggG51e0liOp-&q=85&s=7ebd893fd2a976ebe7cf8af53f8581b8" alt="Ampersand Project Selection" width="2244" height="442" data-path="images/provider-guides/31a6a12-Ampersand.png" />

3. Select **Provider apps**.

4. Select *Webex* from the **Provider** list.

5. Enter the previously obtained *Client ID* in the **Client ID** field and the *Client Secret* in the **Client Secret** field.

6. Click **Save changes**.

## Using the connector

To start integrating with Webex:

* Create a manifest file.

* Deploy it using the [amp CLI](/cli/overview).

* If you're using Read Actions, create a [destination](/destinations).

* Embed the [InstallIntegration](/embeddable-ui-components#install-integration) UI component. This UI component will prompt the customer for OAuth authorization.

* Start using the connector!

  * If your integration has [Read Actions](/read-actions), you'll start getting webhook messages.
  * If your integration has [Write Actions](/write-actions), you can start making API calls to our Write API.
  * If your integration has [Proxy Actions](/proxy-actions), you can start making Proxy API calls.