Setting up the Integrator Role

A 403 Forbidden response when running GET /organizations/<ID>/clients in the integration API is most commonly caused by the integrator role not being added at the organization level.

Note: The following method grants the integrator full access. The integrator role must be added at both the organization level and the client level to enable integrator access. This can be done in the same admin group under Administration.

Once this is done, you should be able to run GET /organizations/<ID>/clients to retrieve a list of all clients you have access to in the integration API.

Integration Organization Level Group

This requires that you have administrator access to your organization and at least one client.

1. Log in as an administrator and select the organization you want to work with in the left-hand menu.
2. Select Groups and create a new group for integration users. See also: Groups - Roles for further information.
3. Go to the Roles tab.
   1. Organization Level — Enable the role "Integration User"
      
   2. Inherited by all clients — Enable the role "Integration User"
4. Now run GET /organizations/<ID>/clients to verify that the integration user has been granted access. You should receive a 200 OK response along with a list of all clients under the organization.