> ## Documentation Index
> Fetch the complete documentation index at: https://stackone-hub-docs-confluence-api-token-update.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Pipedrive - OAuth Authentication

> Follow these steps to connect Pipedrive via the StackOne Hub successfully.

<Warning>
  Ensure you have Admin privileges for your Pipedrive account.
</Warning>

If you've been directed to StackOne to integrate with Pipedrive, the following steps will help you understand the process and any necessary actions to configure successful integration.

## Get Your Company Domain

<Steps>
  <Step title="Open Company Settings">
    To access the Company settings, click on the Profile icon located in the top-right corner, and click Company settings in the menu that appears.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Company Settings" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/kA_-fzt7TEYGckYp/images/pipedrive-oauth/image1.png?fit=max&auto=format&n=kA_-fzt7TEYGckYp&q=85&s=3b82c39274f6c191cab177e26e44b0fb" width="275" height="433" data-path="images/pipedrive-oauth/image1.png" />
    </Frame>
  </Step>

  <Step title="Enter Company Details">
    Under Company Settings, enter your Company name and Company domain. Copy and store your Company domain, then click the Save button.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Company Details" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/kA_-fzt7TEYGckYp/images/pipedrive-oauth/image2.png?fit=max&auto=format&n=kA_-fzt7TEYGckYp&q=85&s=ffb8966b4c1c2b982609945785b9079e" width="994" height="827" data-path="images/pipedrive-oauth/image2.png" />
    </Frame>
  </Step>
</Steps>

## Get Your Client ID and Client Secret

<Steps>
  <Step title="Access Developer Hub">
    To access the Developer Hub, click on the Profile icon located in the top-right corner, and click Developer Hub in the menu that appears.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Developer Hub" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/kA_-fzt7TEYGckYp/images/pipedrive-oauth/image3.png?fit=max&auto=format&n=kA_-fzt7TEYGckYp&q=85&s=9b1f7d4985b5eacd4115fc07eb402a41" width="274" height="429" data-path="images/pipedrive-oauth/image3.png" />
    </Frame>
  </Step>

  <Step title="Create an App">
    Click on the Create an App button to create a Public app.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Create an App" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/kA_-fzt7TEYGckYp/images/pipedrive-oauth/image4.png?fit=max&auto=format&n=kA_-fzt7TEYGckYp&q=85&s=e5a9eceafb83f42a65d867c788a64352" width="1793" height="139" data-path="images/pipedrive-oauth/image4.png" />
    </Frame>
  </Step>

  <Step title="Enter App Details">
    Enter your App name and the Callback URL written below, and click on the Save button.

    Callback URL: `https://api.stackone-dev.com/connect/oauth2/pipedrive/callback`

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="App Details" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/kA_-fzt7TEYGckYp/images/pipedrive-oauth/image5.png?fit=max&auto=format&n=kA_-fzt7TEYGckYp&q=85&s=de054421816dc589da583921924a309f" width="1816" height="742" data-path="images/pipedrive-oauth/image5.png" />
    </Frame>
  </Step>

  <Step title="Select Access Scopes">
    You'll be directed to the OAuth & access scopes page. Select the following Access scopes for your app:

    * Deals - Full access
    * Contacts - Full access
    * Leads - Full access

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Access Scopes" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/kA_-fzt7TEYGckYp/images/pipedrive-oauth/image6.png?fit=max&auto=format&n=kA_-fzt7TEYGckYp&q=85&s=89fddda5e86e7943eeb7ecd9aba2cac1" width="1103" height="697" data-path="images/pipedrive-oauth/image6.png" />
    </Frame>
  </Step>

  <Step title="Copy Credentials">
    Scroll down to Client ID. Copy the displayed Client ID and Client Secret and store them safely, then click the Save button.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Client ID and Secret" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/kA_-fzt7TEYGckYp/images/pipedrive-oauth/image7.png?fit=max&auto=format&n=kA_-fzt7TEYGckYp&q=85&s=9a321fd1fb16d6da04701c6af9ab9687" width="1345" height="685" data-path="images/pipedrive-oauth/image7.png" />
    </Frame>
  </Step>
</Steps>

## Connecting with StackOne

<Steps>
  <Step title="Enter Credentials">
    Upon reaching the Link Account page, enter the credentials from the previous steps:

    * Client ID
    * Client Secret
    * Company Domain

    Proceed by clicking the Connect button.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Link Account" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/kA_-fzt7TEYGckYp/images/pipedrive-oauth/image8.png?fit=max&auto=format&n=kA_-fzt7TEYGckYp&q=85&s=209e08e06af140446dcb251347a8b438" width="480" height="543" data-path="images/pipedrive-oauth/image8.png" />
    </Frame>
  </Step>
</Steps>

<br />

Congratulations, you're all set! If you face any issues with the steps mentioned above,
please contact us by emailing [integrations@stackone.com](mailto:integrations@stackone.com). We're always here to assist you!

## Available data

This integration has the following [IAM Resources](https://docs.stackone.com/reference/iam_list_users) available from the provider:

<ul>
  <li>Users</li>
  <li>Roles</li>
  <li>Groups</li>
  <li>Policies</li>
</ul>