Surge Dedupe connects to Pipedrive with OAuth. You never paste an API token. Pipedrive asks you to allow access, and Surge Dedupe then works as the Pipedrive user who installed it.
Step 1: start the install
Click Install on the Surge Dedupe listing in the Pipedrive Marketplace, or click Start free with Pipedrive on the pricing page. Both lead to the same Pipedrive consent screen.
Step 2: the consent screen
Pipedrive shows the app name and the permissions it asks for. Surge Dedupe asks for these four:
- base: required for every Pipedrive app. It lets Surge Dedupe make API calls on your behalf.
- contacts:full: read your persons and organizations to find duplicates, and merge them. Merging removes the absorbed record, which needs full access, not read access.
- deals:full: read your deals and merge duplicate deals, for the same reason.
- users:read: read the permission set of the Pipedrive user who installed the app. Surge Dedupe uses it to check that this user may merge before merging is released again. Your own name, email and company come from the basic access every app gets.
Click Allow. If you click Deny, nothing is connected and the install screen tells you so. You can install again at any time. More detail per permission is in Permissions Surge Dedupe asks for.
Step 3: finish on the install screen
Pipedrive sends you back to dedupe.sales-surge.io/install with the heading Finish installing Surge Dedupe. It shows which Pipedrive company gave access and as which email address. What you see next depends on your situation.
- New to Surge Dedupe: your email from Pipedrive is filled in. Choose a password of at least 8 characters, confirm it and click Create account and connect. Your account, a new organization named after your Pipedrive company, and the connection are created in one go, and your free trial starts right away.
- You already have an account with that email address: click Sign in, sign in with your password, and you return to the install screen to finish.
- You are already signed in: choose the organization to connect under Connect it to, or choose A new organization, then click Connect Pipedrive. Only an admin of an existing organization can connect it.
When the connection is made you land on the Dashboard with the message Pipedrive connected.
Good to know
- The install link is valid for 30 minutes and works once. If it expired, install again from Pipedrive.
- One Pipedrive company can be connected to one Surge Dedupe organization. If your company is already connected, ask an admin of that organization to invite you.
- An organization that already holds data from another Pipedrive account cannot be switched to a different account. Choose A new organization instead, so data from two companies never mixes.
- Existing customers who connected with an API token keep working. They can switch to OAuth on the Connection page with Connect with Pipedrive.
Still stuck? Email info@sales-surge.nl