---
updatedAt: 2025-11-12T10:34:15.000Z
agentTools:
  projectIndex: https://pipedrive.readme.io/llms.txt
---

# Client ID and client secret

Your app’s unique `client_id` and `client_secret` are values you need to go through [OAuth authorization](https://pipedrive.readme.io/docs/marketplace-oauth-authorization) and receive the `access_token` and `refresh_token` to be used in API requests.

<hr />

## How to get your `client_id` and `client_secret`

<hr />

### New apps

<Image align="center" alt="Create an app in Developer Hub" border={false} width="75% " src="https://files.readme.io/19a5c0e-Developer_Hub_-_create_an_app.png" />

1. [Log in to Developer Hub on your developer sandbox account](https://app.pipedrive.com/developer-hub)
2. Click on “Create an app”
3. Choose whether you would like to create a public or private app
4. In the Basic Info tab of Developer Hub, fill in the required fields – App name and OAuth Callback URL
   * You can insert a non-functioning OAuth Callback URL for the time being. After implementing the logic needed for accepting user authorization in your code, you must update the field with a proper URL.
   * Keep in mind that we allow only one callback URL per app
5. Click the green “Save” button to save the form
6. You’ll automatically be brought to the second tab, “OAuth & access scopes”, where you’ll get your `client_id` and `client_secret`

<Callout icon="📘" theme="info">
  **Take note**: If you initially inserted a non-functioning OAuth callback URL, make sure you change it to a functioning one before submitting it for approval.
</Callout>

### Existing apps

1. [Log in to Developer Hub on your developer sandbox account](https://app.pipedrive.com/developer-hub)
2. Click on your app name and go to the “OAuth & access scopes” tab
3. Scroll down to the Client ID section to find your `client_id` and `client_secret`

<hr />

## How to refresh your `client_secret`

<Callout icon="🚧" theme="warn">
  **NB**: The `client_id` cannot be refreshed or changed for existing apps. The only way to get a new `client_id` would be to create a new app.
</Callout>

<Image align="center" border={false} width="75% " src="https://files.readme.io/ca3dc60-Pipedrive_Developer_Hub_-_refresh_client_secret_-_OAuth_authorization.png" />

1. [Log in to Developer Hub on your developer sandbox account](https://app.pipedrive.com/auth/login)
2. Click on the app name that you want to refresh the `client_secret` for and go to the “OAuth & access scopes” tab
3. Scroll down to the Client ID section and click “Refresh” below your Client secret
4. A dialog box will appear to confirm if you want to deactivate your current client secret and generate a new one
5. Click “Generate new client secret” to obtain your new `client_secret`

Resetting your `client_secret` will not invalidate any user tokens. However, you will need to update any application configuration using the old `client_secret` because it will no longer work.