PipedriveConnect – setup and use
PipedriveConnect synchronises organisations, people and deals in Pipedrive with customers, contacts and sales quotes in Business Central. The synchronisation runs in the job queue, and individual records can be sent manually. All calls to Pipedrive are written to the communication log.
Prerequisites
-
Business Central online, version 26 or later
-
A Pipedrive account and a personal API token (Pipedrive: Settings > Personal preferences > API)
-
The permission set SMIPD (PipedriveConnect) for the users who set up and use the app
-
A customer template, if organisations from Pipedrive are to be created as customers
-
Customers must have a company contact if their contacts are to be synchronised
Getting started
-
Search for Pipedrive Setup and open the page. The first time, a 14-day trial licence is inserted automatically.
-
Paste the API token into the API Token field. The API base URL is filled in in advance.
-
Select Test connection. The page shows which Pipedrive user and company the token belongs to.
-
Select Get users, stages and fields. Users with the same email address as a salesperson are linked automatically.
-
Open Users and check the link between Pipedrive users and salespeople.
-
Switch on the directions that are to be synchronised, and set Enabled to on.
-
Select Synchronise now for a first run, and see the result in Communication Log.
-
Select Create job queue entry, and set the entry to Ready when everything looks right.
The setup page
General
Enabled – switches the synchronisation on or off. When it is off, the job queue does nothing and changes are not registered.
API base URL – normally https://api.pipedrive.com/v1.
API token – stored encrypted and never shown again. Clear the field to remove the token.
Visible to – the visibility in Pipedrive for records created from Business Central: 1 = owner and followers, 3 = entire company. Some Pipedrive subscriptions use 5 and 7.
Linked salespeople only – when the field is switched on, only customers, contacts and quotes with a salesperson who is linked to a Pipedrive user are sent automatically.
New customers
Create customers – Manually from the organisation list or Automatically for all new organisations.
Customer template – gives new customers number series, posting groups and payment terms.
Block new customers – blocks customers created from Pipedrive until someone has checked them.
Deals
Default stage for new deals – the stage that new deals from sales quotes start in. Empty = the first stage in the default pipeline.
Create deals for quotes from – only sales quotes with a document date on or after this date automatically get a deal. Fill in with the installation date.
Mark deal as lost when quote is deleted – a quote that is deleted without becoming an order marks the deal as lost.
Archive and delete lost quotes – when a deal is marked as lost in Pipedrive, the quote is archived and deleted in Business Central.
Synchronisation
Each direction is switched on separately: Customer -> Organisation, Contact -> Person, Sales quote -> Deal and the reverse. Each direction can have its own job queue category, so that for example deals can run more often than customers. Leave the category empty to run the direction with all Pipedrive job queue entries.
Communication log
Log level – All calls, Errors only or None.
Keep log entries (days) – older entries are deleted by the job queue. 0 keeps all entries.
Licence
Licence key – select Click to request licence to start a trial licence or request a full licence. Status/expiry shows whether the licence is valid.
How data is synchronised
Customers and organisations
Customers are sent to Pipedrive with name, address, owner (from the salesperson) and the fields that are mapped. A customer that is changed is marked and sent at the next run. From Pipedrive, name, address, country, salesperson and mapped fields are updated on linked customers. New organisations can be created as customers automatically or with Create customer in the Pipedrive Organisations list. An existing customer can be linked by selecting it in the Customer No. field.
Contacts and people
Contacts (type Person) on linked customers are sent to Pipedrive with name, email, phone and organisation. New people in Pipedrive on a linked organisation are created as contacts on the customer's company contact.
Sales quotes and deals
Sales quotes are sent as deals with title (quote no. and customer name), amount excl. VAT, currency, expected close date (Quote valid until), owner and, where applicable, person. If the customer is not yet in Pipedrive, it is created first. If the amount or the quote's fields change, the deal is updated at the next run.
When a quote is converted to an order, the deal is marked as won with the order's amount. If the quote is deleted without an order, the deal is marked as lost (can be switched off). From Pipedrive, the deal's stage and status (Open, Won, Lost) are shown on the sales quote. The queue Quotes won in Pipedrive on the role centre shows quotes whose deal has been won.
Field mapping
With field mapping, Pipedrive fields – including your own fields such as company registration no., EAN number or contribution margin – are linked to fields on customers (Organisation), contacts (Person) and sales quotes (Deal).
-
Open Field Mapping from the setup page and select Get Pipedrive fields.
-
Create one line per field: select Pipedrive type, Pipedrive field key and Business Central field no.
-
Select the direction: Both directions, Business Central to Pipedrive or Pipedrive to Business Central.
Values are validated in Business Central when they come from Pipedrive. Fields of the option list type in Pipedrive are sent as IDs – use ordinary text, number and date fields in Pipedrive for mapping.
Communication log
All calls between Business Central and Pipedrive are logged with date/time, user, direction, action, HTTP method and status, duration, error message and the link to the record in Business Central and the Pipedrive ID. Open an entry to see the full request and the full response. The API token is never part of the log.
The log also shows what Business Central did with data from Pipedrive, for example "Customer 10000 created from organisation 42". Select Pipedrive Log on the customer, contact or sales quote card to see all calls for that particular record.
Job queue
Select Create job queue entry on the setup page. The entry runs every 15 minutes on weekdays and is created with status On Hold. Codeunit: 6240086 (SMIPDSyncJob). A job queue entry without a category runs all enabled directions. If you want to run directions at different frequencies, create several entries, each with its own job queue category, and enter the categories on the setup page.
Troubleshooting
Test connection fails with HTTP status 401 – the API token is wrong or has been revoked. Paste a new token.
Nothing is sent – check that Enabled and the direction are switched on, that the licence is valid, and that the salesperson is linked to a Pipedrive user when Linked salespeople only is switched on.
Organisations do not become customers – enter a customer template, and select Automatically or use Create customer in the list.
Contacts are not sent – the customer must have a company contact, and the person must have the type Person.
A value from Pipedrive does not come across – see the communication log. The value must be valid in the mapped Business Central field.
Support
Contact: sc@systemconnect.dk
© 2026 SystemConnect
