Steps
-
Create a Pipedrive Application
- Go to the Pipedrive Developer Hub (use a developer sandbox account)
- Click Create an app
- Choose the app type:
- Public Application: Available to all Pipedrive users (requires review/approval)
- Private Application: Only for selected users (no review needed)
-
Configure Basic Info
- Go to the Basic Info tab
- Fill in:
- App name (must be unique for public apps)
- Callback URL: Your OAuth callback URL
- Click Save
-
Get OAuth Credentials
- Go to the OAuth and access scopes tab
- Scroll down to find:
- Client ID
- Client Secret
- Copy both values
-
Configure Scopes
- In the same OAuth and access scopes tab, find the Access Scopes section
- By default, Pipedrive only provides basic read access
- Select scopes with either Read only or Full access for each resource:
- Contacts, Leads, Mail, Activities, Products, Projects
- Common full-access scopes:
contacts:full,leads:full,mail:full,activities:full,products:full,projects:full
-
Submit for Review (public apps only)
- Go to the App review info tab and submit for review
- Private applications don’t require review
Key Details
- Developer Hub: https://app.pipedrive.com/developer-hub
- Auth Type: OAuth 2.0
- Base API URL:
https://api.pipedrive.com/v1 - Credentials Location: App → OAuth and access scopes tab
- Common Scopes:
contacts:full,leads:full,mail:full,activities:full,products:full,projects:full - Scope Levels:
Read onlyorFull accessper resource