> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect PingOne with OAuth 2.0 (Client Credentials) – StackOne Hub

> Link a PingOne account in the StackOne Hub using OAuth 2.0 (Client Credentials). End-user guide to authorize the integration and start using PingOne actions.

> [!WARNING]
>
> You need an administrator role in PingOne to create the Worker application and grant it roles. PingOne lets you grant only the responsibilities you have yourself.

## Create a Worker application

StackOne connects as a PingOne **Worker** application, and its access follows the roles you grant it.

**1. Create the application**

Sign in to the [PingOne admin console](https://console.pingone.com) for North America, or the console for your region: [Europe](https://console.pingone.eu), [Canada](https://console.pingone.ca), [Singapore](https://console.pingone.sg), or [Australia](https://console.pingone.com.au). Then go to **Applications > Applications**.

<ul>
  <li>Click the plus icon next to **Applications**.</li>
  <li>**Application Name**: `StackOne Integration`</li>
  <li>**Application Type**: **Worker**</li>
  <li>Click **Save**.</li>
</ul>

![The Add Application panel with the application name filled in and the Worker application type selected](https://mintcdn.com/stackone-60/lr5NNUCg8a6F9_0d/connectors/pingone/images/oauth2_client_credentials-config-add-application.png?fit=max\&auto=format\&n=lr5NNUCg8a6F9_0d\&q=85\&s=5bad1e54a895b1365519d4c55dec2668)

**2. Grant the Environment Admin role**

Worker applications have no roles by default. PingOne opens the new application on its **Roles** tab.

<ul>
  <li>Click **Grant Roles**.</li>
  <li>On the **Available responsibilities** tab, expand **Environment Admin**.</li>
  <li>Under **Environments**, select the environment you are connecting.</li>
</ul>

![The Environment Admin responsibility expanded with an environment selected](https://mintcdn.com/stackone-60/lr5NNUCg8a6F9_0d/connectors/pingone/images/oauth2_client_credentials-config-environment-admin.png?fit=max\&auto=format\&n=lr5NNUCg8a6F9_0d\&q=85\&s=9ab139afde33f9653786be4fc7bc46e8)

**3. Grant the Identity Data Admin role**

User data needs its own role, so grant **Identity Data Admin** in the same panel.

<ul>
  <li>Expand **Identity Data Admin**.</li>
  <li>Under **Environments**, select the same environment.</li>
  <li>Click **Save**.</li>
</ul>

![The Identity Data Admin responsibility expanded with the same environment selected and the Save button](https://mintcdn.com/stackone-60/lr5NNUCg8a6F9_0d/connectors/pingone/images/oauth2_client_credentials-config-identity-data-admin.png?fit=max\&auto=format\&n=lr5NNUCg8a6F9_0d\&q=85\&s=f5136fadf5321e43f13cf83dd9859731)

**4. Enable the application**

Click the toggle at the top of the application's details panel so it turns blue.

![The application details panel with the enable toggle at the top](https://mintcdn.com/stackone-60/lr5NNUCg8a6F9_0d/connectors/pingone/images/oauth2_client_credentials-config-enable-application.png?fit=max\&auto=format\&n=lr5NNUCg8a6F9_0d\&q=85\&s=2a04343169669d87684ff36a5284d836)

**5. Copy the credentials**

Open the **Configuration** tab. Keep **Grant Type** as **Client Credentials** and **Token Auth Method** as **Client Secret Basic**.

<ul>
  <li>Copy the **Environment ID** across.</li>
  <li>Copy the **Client ID** across.</li>
  <li>Copy the **Client Secret** across.</li>
</ul>

![The Configuration tab with the copy icons for Environment ID, Client ID and Client Secret](https://mintcdn.com/stackone-60/lr5NNUCg8a6F9_0d/connectors/pingone/images/oauth2_client_credentials-config-copy-credentials.png?fit=max\&auto=format\&n=lr5NNUCg8a6F9_0d\&q=85\&s=86d1b8851501db79010dcbce318d3325)

## Find your region

The region is the PingOne geography your environment is hosted in.

**1. Select the region**

Go to **Settings > Environment Properties** and read the **Region** value.

<ul>
  <li>Select the matching option from the **Region** list.</li>
  <li>Example: a **Region** of `North America (US)` means you select **North America**</li>
</ul>

![The Environment Properties page with the Region field](https://mintcdn.com/stackone-60/lr5NNUCg8a6F9_0d/connectors/pingone/images/oauth2_client_credentials-config-region.png?fit=max\&auto=format\&n=lr5NNUCg8a6F9_0d\&q=85\&s=08fb5948fdd05c166821c3fd67f3b4dd)

## Link the Account

**1. Connect**

<ul>
  <li>Click **Connect**.</li>
  <li>If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider's authorization flow.</li>
  <li>Once authorization is successful, you will see a confirmation popup.</li>
</ul>

**2. Use Actions**

Connect an AI platform to the linked account's actions. See [AI Platforms](https://docs.stackone.com/ai-platforms/overview.md).

Other ways to call actions are listed in [Protocols & SDKs](https://docs.stackone.com/connect/protocols-and-sdks.md).

## Next Steps

> [card] [Webhooks setup](https://docs.stackone.com/connectors/pingone/guides/webhook-setup.md)
>
> Configure receiving Events for PingOne into StackOne.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.