Pipedrive

{/* Generated by scripts/generate-integration-catalog.mjs. Do not edit by hand. */}

At a glance

  • Availability: Experimental (how to enable).
  • Authentication: OAuth 2.0.
  • Connection: A user authorizes the connection in the provider's consent screen.
  • Scopes: base, deals:full, contacts:full.
  • Provider documentation: Authentication reference.

Credentials

Set these per environment. See Connect an integration.

These variables are required only when you supply your own OAuth app. If a managed app is available, you can connect without setting them. Provider permissions and consent still apply.

VariableRequiredDescription
PIPEDRIVE_CLIENT_IDYesPipedrive OAuth Client ID (from your app in the Developer Hub) Docs.
PIPEDRIVE_CLIENT_SECRETYesPipedrive OAuth Client Secret Docs.

Setup

  1. Create a Pipedrive developer sandbox: Request a free developer sandbox account at https://developers.pipedrive.com/start-here - apps can only be created from a sandbox or company account with admin rights.
  2. Create an app in the Developer Hub: In Pipedrive, open Tools and apps → Developer Hub (or https://app.pipedrive.com/developer-hub) and create an app. A private/unlisted app is fine for internal use.
  3. Set the callback URL and scopes: Set the OAuth callback URL to your app URL ending in /api/auth/pipedrive/callback and enable the deals:full, contacts:full, and search:read scopes (base is always included).
  4. Copy credentials and verify: Copy the Client ID and Client Secret from the app's OAuth & access scopes page into PIPEDRIVE_CLIENT_ID and PIPEDRIVE_CLIENT_SECRET, connect your account, and run the List Deals tool.

Provider notes

  • The token endpoint authenticates the client with HTTP Basic (base64 of client_id:client_secret)
  • Access tokens expire after about 60 minutes; refresh tokens are issued and expire if unused for 60 days
  • API calls go to the company-specific host returned as api_domain in the token response (e.g. https://yourcompany.pipedrive.com); tool URLs template it via {{oauth.raw.api_domain}}

Provider API reference.

Tools

ToolAccessDescription
List Deals<br /><code className="reference-identifier">pipedrive__list_deals</code>ReadList deals
Get Deal<br /><code className="reference-identifier">pipedrive__get_deal</code>ReadGet deal
Create Deal<br /><code className="reference-identifier">pipedrive__create_deal</code>WriteCreate deal
Update Deal<br /><code className="reference-identifier">pipedrive__update_deal</code>WriteUpdate deal
List Persons<br /><code className="reference-identifier">pipedrive__list_persons</code>ReadList persons
Create Person<br /><code className="reference-identifier">pipedrive__create_person</code>WriteCreate person
List Organizations<br /><code className="reference-identifier">pipedrive__list_organizations</code>ReadList organizations

Verify the connection

Call a read tool such as pipedrive__list_deals with arguments for your account. Confirm that the result comes from the intended account or workspace before enabling write tools.