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

# Pipedrive

> Provider ID: `Pipedrive`

## Getting Started

You can connect to the Pipedrive API using a personal API key or an OAuth app. For connecting a single Pipedrive account, we recommend using an API key.

### API Key Setup

<Steps>
  <Step title="Find your Pipedrive API Key">
    In your Pipedrive account, navigate to **Settings** > **Personal preferences** > **API**. Copy your personal API key.

    <Note>
      If you cannot find your API token, your permission set may not have this access enabled. Contact your Pipedrive admin to update your permissions.
    </Note>
  </Step>

  <Step title="Configure the Pipedrive Integration in Strata">
    Select Pipedrive in the [Strata Integration Catalog](https://app.connectstrata.com/integrations/catalog). Enter your Pipedrive API key.
  </Step>
</Steps>

### OAuth App Setup

<Warning>
  Pipedrive public apps are not yet supported
</Warning>

<Steps>
  <Step title="Create a Pipedrive Sandbox Account">
    Sign up for a [Pipedrive Sandbox account](https://developers.pipedrive.com/).
  </Step>

  <Step title="Create a Pipedrive App">
    1. Create a Pipedrive private app. In the "Basic Info" section, provide the Strata OAuth callback URL:

    ```text theme={null}
    https://connect.connectstrata.com/oauth/callback
    ```

    2. Select the access scopes required by your use cases
    3. Copy the Client ID and Client Secret for setup in Strata
  </Step>

  <Step title="Configure the Pipedrive Integration in Strata">
    Select Pipedrive in the [Strata Integration Catalog](https://app.connectstrata.com/integrations/catalog). Enter your OAuth client ID, secret, and the access scopes you requested in Pipedrive.

    <Note>
      It's important that the scopes provided in the Strata dashboard exactly match
      the scopes you requested in your Pipedrive app
    </Note>
  </Step>
</Steps>