---
title: Registering PingFederate as an app in Slack
description: Before PingFederate can access the Slack API, it needs an access token. To get the access token, you need to register PingFederate as an app in Slack.
component: slack
page_id: slack:setup:pf_slack_connector_registering_pf_as_an_app_in_slack
canonical_url: https://docs.pingidentity.com/integrations/slack/setup/pf_slack_connector_registering_pf_as_an_app_in_slack.html
revdate: July 8, 2024
section_ids:
  steps: Steps
---

# Registering PingFederate as an app in Slack

Before PingFederate can access the Slack API, it needs an access token. To get the access token, you need to register PingFederate as an app in Slack.

## Steps

1. Sign on to Slack as an Admin or workspace Owner.

   If you don't already have a Slack workspace, create one. For help, see [Getting started for workspace creators](https://slack.com/intl/en-ca/help/articles/217626298-Getting-started-for-workspace-creators) in the Slack documentation.

2. Go to the Slack [Your Apps](https://api.slack.com/apps) window.

3. Click **Create New App**.

4. On the **Create a Slack App** modal, enter a name and select a workspace. Click **Create App**.

5. On the **Basic Information** window, in the **App Credentials** section, note the **Client ID** and **Client Secret**.

   You will use these in [Getting a Slack API access token](pf_slack_connector_getting_a_slack_api_access_token.html).

6. In the navigation pane, click **OAuth & Permissions**.

7. On the **OAuth & Permissions** window, in the **Redirect URLs** section, add the Ping Identity OAuth Configuration Service (OCS).

   1. Click **Add New Redirect URL**.

   2. In the **Redirect URLs** field, enter the following:

      ```
      https://oauth.pingone.com/ocs/ppm/rest/v1/oauth/oastempcredresponse/
      ```

   3. Click **Add**. Click **Save URLs**.

8. In the **Scopes** section, add the admin scope.

   1. In the **User Token Scopes** section, click **Add an OAuth Scope**.

   2. Select **Admin**.

9. Submit your app to the [Slack App Directory](https://slack.com/apps).

   |   |                                                                                      |
   | - | ------------------------------------------------------------------------------------ |
   |   | This step is required for Slack Enterprise Grid, but optional for other Slack plans. |

   1. In the navigation pane, click **Manage Distribution**.

   2. In the **Remove Hard Coded Information** section, select the **I've reviewed and removed any hard-coded information** check box.

   3. Click **Activate Public Distribution**.