Before you start
- You are signed in to Syntaxia under the Data Ops function.
- You are an Admin user on the Pipedrive company you want to connect, or you have permission to authorize OAuth integrations.
- Your Pipedrive plan supports API access. All paid plans do.
What syncs
| Object | Notes |
|---|---|
Organization | Companies in Pipedrive |
Person | Contacts associated with organizations and deals |
Deal | Opportunities in your pipelines |
Activity | Tasks, calls, meetings, and notes |
User | Pipedrive users, used for owner attribution |
Connect Pipedrive
Add the source
From your Data Ops command center, click Add Source, expand the Pipedrive card, and enter a connection label like
Pipedrive - SDR Team.Authorize Syntaxia
Click Connect. You will be redirected to Pipedrive. If you are signed in to multiple Pipedrive companies, select the one you want to connect, then click Allow and install.
Return to Syntaxia
Pipedrive redirects you back to your command center. The new source card shows status
syncing.Required Pipedrive permissions
The integration installs against the company you select during OAuth. Make sure the authorizing user has at least:- Read access to Deals, Organizations, Persons, and Activities in their permission set.
- The Use API permission, which is granted by default to Admin users.
After the first sync
Once your Pipedrive source isactive, you can:
- Resync at any time to pull the latest changes.
- Run ontology discovery to model your Pipedrive structure. See Ontology discovery.
- Compose with other source ontologies. See Ontology composition.
Troubleshooting
The OAuth window shows the wrong company
The OAuth window shows the wrong company
Sign out of Pipedrive in another tab, then click Reconnect on the source card. Pipedrive will prompt you to choose a company before authorizing.
The card is in `error`
The card is in `error`
Pipedrive reported a broken connection. The user who authorized may have left the company or had their permissions changed. Click Reconnect and re-authorize as a current Admin.
Some deals are missing
Some deals are missing
Check the visibility settings on the affected pipelines and the permission set of the authorizing user. Syntaxia inherits the user’s view of Pipedrive.