OAuth API Token Generation

An OAuth API token with the admin scope is required to access the Slack SCIM API.

To acquire the OAuth API token an organization owner must:

  • create a new Slack application

  • add the admin OAuth scope

  • install the application

  • use the generated token

Perform the following steps to generate an OAuth API token:

  1. Create a new Slack application as an admin on a Workspace. For more information, refer to Creating, managing, and building apps.

  2. Configure the permissions to allow your application to interact with the Slack API by adding the admin OAuth scope in the User Token Scopes.

  3. Install the Slack application. For more information, refer to Installing and distributing apps.

  4. Use the generated OAuth Access token.

Note
If you intend to build a Slack application for other teams to install, your application will be required to properly handle the OAuth flow to generate the correct token.

Additional Information

The API token must be included through an Authorization header with a type of Bearer when calling any of the SCIM methods. Provide a JSON request body for POST, PUT, and PATCH write operations, and then set HTTP Content-type header to application/json.

For example, the SCIM call can be as follows:

GET /scim/v1/Users?count=1000 HTTP/1.1

Host: api.slack.com

Accept: application/json

Authorization: Bearer xoxp-4956040672-4956040692-6476208902-xxxxxx