Configure Connection

Last updated: October 26, 2026NIM service baseline: v7.0.1866

Cisco Webex guide

Register a Webex OAuth integration, authorize it through NIM, and test access to the people endpoint.

Before you start

Review the Webex getting started guide and OAuth integration instructions. NIM requires Client ID and Client Secret. The Redirect URI for authorization is provided on the NIM system's Connection screen.

Create a Webex OAuth integration

1. In NIM Studio, open Systems > Overview and add a Cisco Webex system, or select the existing system.
2. Open its Connection screen and copy the Redirect URI provided by NIM.
3. Sign in to the Webex Developer Portal, open My Webex Apps, and select Create a New App > Create an Integration.
4. Enter the integration details and add the Redirect URI copied from NIM exactly as displayed.
5. Select the read scopes needed for the data your audit will collect. Confirm that the Webex account authorizing the integration has the permissions required for that data.
6. Save the integration and securely record its Client ID and Client Secret.

Enter the credentials and authorize access

1. Return to the Cisco Webex system's Connection screen in NIM.
2. Enter the following settings and save the connection.

NIM setting	Value
Client ID	The client identifier generated for the Webex OAuth integration.
Client Secret	The secret belonging to that Webex integration.

3. Start the authorization flow from NIM, sign in to Webex, and approve the requested access.
4. Complete the redirect back to NIM. If authorization fails, verify the credentials, registered Redirect URI, selected scopes, and authorizing account's permissions.

Test the people endpoint

1. Select Test Connection. NIM calls:

   GET /v1/people

   This request checks access to the people endpoint.

2. Confirm that the test succeeds. If it fails, verify that OAuth authorization completed and that the integration and authorizing account can read the intended people data.

3. Collect the system and inspect people, groups, licenses, and roles, along with any other collections required for your audit.

4. Confirm that the returned data covers the intended organization and users before using it in NIM filters and reports.

The connection test checks the people endpoint. Validate access to other collections separately. This connector is read-only.

Step 1 of 3

Report a problem with this page

Found an error or a missing step? Open the feedback form and describe what needs changing. The article details and Documentation topic are filled in for you.

Need help with your NIM environment? Contact Support.