Organization Client

Organization client represents an application user account type in the Switch platform that allows simple but powerfull integration with the Switch API.

In order to get an access token from the Switch Authorization Server, you need to pass valid client ID and client secret in the request as explained in Client Credentials Flow. For this purpose you need to create an Organization Client.

The Switch app offers a way for the organization administrators to manage their organization clients, such as view, and delete existing clients, create new clients and manage each client secrets.

Manage Clients

View clients

Follow the steps below to see your organization clients and their respective IDs.

  1. In the upper-right corner of any page in the Switch app, click the User icon, then click on the organization for which you whish to see the clients for.

  2. Next, in the upper-right corner of any page on Switch app, click the Settings icon, then click My organization.

  3. Next, in the left sidebar menu click API.

  4. List of existing organization clients with their respective client IDs will be shown on the right, under the Clients tab.

    Organization clients IDs

In case there are no existing organization clients available for the organization, an empty list will be shown. In this case just proceed to the next topic about creating new organization client.

Create client

To create new organization client you first need to be on the View clients page as explained above and follow the steps below.

  1. Click on the Create client button on the right.

    Create organization client
  2. Next, enter the client Name, select which roles the client should have from the list of Available roles, and click the Save button in the bottom-right.

  3. After saving, the newly created client with its respective client ID will be shown in the list of existing clients.

    Newly created client

Rotate client secret

To rotate the client secret you need to be on the View clients page as explained above and follow the steps below.

  1. Click on the rotate button right next to the secret hint, of the client secret that you want to rotate.

  2. The secret will be rotated and the new value will be shown until you refresh the page, after which you will be able to see only the secret hint.

Delete client

To delete existing organization client you need to be on the View clients page as explained above and follow the steps below.

  1. Click on the Delete button on the right of the client name, of the client you want to delete.

    Delete client

Client roles

The roles associated with organization client ensure which permissions the client will have when accessing the SwitchmarketAPI. It is important that you are aware of this when changing the roles to the organization client since you might lose some permissions that you require, or give some permissions that you did not intended to, depending on which roles you will select. To manage the associated roles with a client you need to be on the View clients page as explained above and follow the steps below.

  1. Click on the pencil-like edit icon below the client name, right next to list of associated roles, after which the Roles popup window will be shown.

    Manage client roles
  2. Select from the Available roles shown on the left to add/associate them with the client. Click on the Selected roles shown on the right to remove/dissociate them from the client. Click on the Save button in the bottom-right to save the changes.

Last updated

Was this helpful?