Authorize an OAuth client

Prerequisites
  • OAuth > Client > Authorize permission

Only an approved Genesys Cloud administrator can authorize an OAuth client. Users without permissions are shown a permissions error indicating an administrator is required to approve this application.

Select the authorization procedure that applies to you:

To authorize clients (known client ID):

  1. Click Admin.
  2. Under Integrations, click Authorized Applications.
  3. Click Authorize a client.
  4. Enter the Client ID and click Authorize client.

  5. Select the required scope.
    Note: If you have questions if a scope is required, check with the application developer before approving Scope.

  6. Click Approve.

To authorize clients (unknown client ID):

  1. Launch the external application.
    Note: The application might be within the Genesys Cloud menu structure, or completely independent of the Genesys Cloud application.
  2. When prompted to log in, use a Genesys Cloud administrator account.
  3. Select the desired scopes.
    Note: If you have questions if a scope is required, check with the application developer before approving Scope.

  4. Click Approve.

The built-in clients are enabled by default. To authorize clients (built-in clients):

  1. Click Admin.
  2. Under Integrations, click Authorized Applications
  3. Select the required following built-in client from the list: Android Collaborate, Architect, Directory Web Client (Unified App), and iOS Collaborate.    
  4. In the Client ID field, enter the client ID for the built-in clients and click Authorize Client.                              
    Note: You can view the list of Client IDs from the OAuth page.
  5. In the Scope section, define the scope of access to the client as required.
    Note: As an administrator you can enable access to the built-in client for all roles that require access to the client.
     
  6. Click Add Roles.                      
  7. Select the roles that require access to the application.
  8. Click OK.

    To disable clients, click Revoke Authorization. Doing this disables access to the application for all roles including administrators.