Configuring API credentials

If enabled for an account, users with an admin or supervisor license can use the API Credentials area to create user-level API credentials to use with Vonage Contact Center APIs.

Users need API credentials when using the APIs available at Vonage Contact Center APIs.

For more information about API Credentials, see API Credentials.

Depending on your license, you can perform different tasks in API Credentials:

• Create your own user-level credentials
• View your own credentials
• View all credentials (admin user only)
• Edit your own user-level credentials
• Edit account-level credentials (admin user only)
• Delete your own credentials
• Delete all credentials (admin user only)

How do I create new user-level API credentials?

To create user-level API credentials for your account, perform the following steps:

1. Log in to Vonage Contact Center and go to API Credentials (within Account Settings). API Credentials appears. If applicable, go to the Users tab.
   Click Create New. Create API Credentials appears.

2. Provide the following information:

   Field	Description
   Name	A name to identify the credentials later. We recommend that you use a name that describes the credential's intended use. Type a name for the credentials. You can edit this later.
   Scopes	The scope or scopes that you want these API credentials to work with. In the Scopes list, click to see the available scopes.  Available scopes Available scopes depend on your user license, admin or supervisor. Admin users have all scopes available; supervisors have only Read or download interaction content and Read VCC user details, settings, and presences. Click the name of the scope to add it. Click x alongside the scope name to remove it. Add as many scopes as you like to your API credentials. See the documentation for individual APIs to see which scopes you will require. You can edit the list of scopes later.

3. Click Create. A Success message appears and your new credentials appear.
   Copy and save your client ID and secret; you cannot retrieve them later. You will need your client ID and client secret every time you make a call to authenticate with a Vonage Contact Center API
4. Click OK. Your new credentials appear—without the secret—in API Credentials.

How do I view API credentials in my account?

Depending on your license, you can locate and view different API credentials:

• If you are a supervisor user, when you go to API Credentials only your own (user-level) API credentials appear. No one else's credentials appear.
• If you are an admin user and your account contains no account-level API credentials, all user-level API credentials in your account appear. Use the Filter list to switch between viewing all credentials in your account (All Credentials) and your own credentials (My Credentials).
• If you are an admin user and your account contains previously created account-level API credentials, two tabs appear: Users and Accounts. User-level credentials appear on the Users tab. Use the Filter list to switch between all credentials and your own credentials as described earlier. Account-level credentials appear on the Accounts tab.

Click to open and view individual API credentials.

How do I edit API credentials?

Depending on your license, you can edit different API credentials. As a supervisor user, you can only edit your own user-level credentials; admin users can additionally edit any existing account-level credentials. No one can modify someone else's user-level credentials.

From API Credentials, click to open the API credentials you wish to change.

You can add or remove scopes to or from the API credentials. A new scope might give the credentials access to a different API, or additional access to an already allowed API.

You can also change the name of the API credentials.

When you have finished making changes, click Save API credential.

How do I delete API credentials?

Depending on your license, you can delete different API credentials. As a supervisor user, you can only delete your own user-level credentials; admin users can delete any API credentials.

If you no longer require particular API credentials, from API Credentials click the trash can icon at the right of the API credentials you want to delete, and click Delete API credentials in the dialog box that appears.

Configuring API credentials