---
title: "Linkbreakers + Pipedrive: QR code leads as persons, leads and deals"
description: "Connect Pipedrive with a personal API token and every person who scans your QR codes and gives their email or phone becomes a Pipedrive person, with a label, their form answers in custom fields, and optionally a lead or a deal in the pipeline stage you choose. Setup, what is synced, one open deal per person, and the Assistant and MCP tools."
canonical: "https://linkbreakers.com/help/article/linkbreakers-pipedrive-integration-qr-sales-pipeline-automation"
last-updated: 2026-11-09
---

# Linkbreakers + Pipedrive: QR code leads as persons, leads and deals

> Connect Pipedrive with a personal API token and every person who scans your QR codes and gives their email or phone becomes a Pipedrive person, with a label, their form answers in custom fields, and optionally a lead or a deal in the pipeline stage you choose. Setup, what is synced, one open deal per person, and the Assistant and MCP tools.

:::try-ai-prompt {"prompt":"Connect Pipedrive with my API token, label synced persons as Trade show, and create a deal in the first stage of my Sales pipeline for each new person","description":"Connect Pipedrive with the Assistant.","target":"assistant"}:::

## Short answer

Linkbreakers connects to Pipedrive directly. In the dashboard, open **Integrations**, pick **Pipedrive**, paste your Pipedrive personal API token and select **Connect**. From then on, every person who goes through one of your links or QR codes and whose email or phone Linkbreakers knows, for example after a lead form, is created or updated as a Pipedrive person, with their name, email, phone and form answers. You can give them a person label, and have Linkbreakers create a lead or a deal for each one, in the pipeline and stage you choose.

No Zapier, Make or webhook is needed. The integration is available on every plan.

## Quick summary

- Connect once per workspace with a personal API token from **Personal preferences > API**
- Persons are created or updated, matched on email (or on phone when there is no email)
- Visitors known only by their phone number are synced too
- Optionally a person label, added to the labels the person already has
- Form answers go to person custom fields with the same name
- Optionally a lead (Leads Inbox) or a deal in a pipeline stage, one open per person
- Only people's visits: bots, link previews and AI agents never become persons
- Also set up from the Assistant, the MCP server or the REST API

## How it works

A person is synced when a visitor goes through a step of a link's workflow and Linkbreakers knows their email or phone. That is usually right after a [lead form](/help/article/how-to-add-a-lead-capture-form-to-a-qr-code), but it can also come from the chat bot or any step that saves visitor data. Linkbreakers sends the person to Pipedrive from its servers, once per step, at the moments the connection covers (all of them by default).

Linkbreakers looks the person up by email, or by phone when the visitor gave no email. An existing person is updated: a new phone is added next to the ones they have, and a label is added to theirs, never replacing them. A new person is created with the name, email and phone. No organization is written.

## Connect Pipedrive

1. In Pipedrive, open your name > **Personal preferences > API** and copy your personal API token (40 letters and digits).
2. In Linkbreakers, open **Integrations** in the dashboard and pick **Pipedrive**.
3. Paste the token in **Pipedrive API token** and select **Connect**. Linkbreakers checks it against Pipedrive before storing it.
4. Under **Add contacts to a person label**, choose a label, or **No person label: contacts only**. Pipedrive has no mailing lists: the label is how synced persons are grouped.
5. Under **What Pipedrive gets for each person**, choose the contact only, the contact and a lead, or the contact and a deal (with its pipeline and stage).
6. Set the delivery setting below, then save.

The token is encrypted when it is stored and never shown again. It acts as the Pipedrive user it belongs to, so persons, leads and deals are created as that user.

## What gets synced

| Linkbreakers | Pipedrive |
|---|---|
| Email | Person email (work) |
| Phone | Person phone (mobile), added to the ones they have |
| First and last name | Person name (the email or phone when there is no name) |
| Form answers and other visitor data | Person custom fields, matched by name |
| The label you chose | Added to the person's labels |
| Lead or deal (optional) | A lead, or a deal in the chosen pipeline stage, linked to the person |

Pipedrive keys custom fields by a random code, so Linkbreakers matches them by name: a field named "Cafe name" takes the answer whose key is `cafe_name`. Create them in Pipedrive under **Settings > Data fields > Person**, named like your form fields, or map an answer to a field on the Pipedrive page. Text, phone, number and date fields are written; option, people, monetary and address fields are left out. **Test connection** lists the field keys Linkbreakers can write to.

## Leads and deals

Choose **The contact and a lead** to create a lead in the Leads Inbox, or **The contact and a deal** to create a deal in the pipeline and stage you pick. The title defaults to `{link}: {name}`, where `{link}` is the name of the link the person came through and `{name}` their name, or their email or phone. You can change it.

A visitor goes through several steps of a flow, and is synced at each one, but your sales team wants one opportunity per person. So Linkbreakers creates no deal or lead while the person has an open deal, and no lead while they have a lead that is not archived. Once the deal is won or lost, or the lead archived, a new visit creates a new one.

## Marketing consent

Pipedrive has no marketing subscription that Linkbreakers can set (it exists only with the Campaigns add-on, which the API does not let a sync rely on), so nobody is subscribed to anything in Pipedrive. You can still choose a consent answer under **Marketing consent** and tick **Add to the person label only those who consented**, so the label marks the people who agreed to hear from you.

## Which visitors and which links

The Pipedrive page has the same three settings as the other Linkbreakers integrations:

- **Where**: every link, or only some links, directories and tags
- **When**: the moments of a visit (Entry, Interaction, Routing, Exit), or specific steps
- **What is sent**: all visitor data, only some, or just the visit. Email and phone are always sent, since they are what makes a person

Only visits by people are synced. Visits past your plan's tracked visits allowance are not synced.

## Set it up from the Assistant, MCP or the API

**Assistant**: in the dashboard, ask "Connect Pipedrive with my API token and create a deal in my Sales pipeline for each new lead".

**MCP server**: an agent connected to the [Linkbreakers MCP server](/help/article/mcp-server-setup) has `contact_integration_connect`, `contact_integration_lists` (the person labels), `contact_integration_pipelines`, `contact_integration_fields`, `contact_integration_update`, `contact_integration_test`, `contact_integration_get`, `contact_integrations_list` and `contact_integration_disconnect`, with the tool `CONTACT_TOOL_PIPEDRIVE`.

**REST API**, with a token that has the `integrations:write` scope:

```bash
curl -X POST https://api.linkbreakers.com/v1/integrations/contacts/CONTACT_TOOL_PIPEDRIVE/connect \
  -H "Authorization: Bearer $LINKBREAKERS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"apiKey": "your-pipedrive-api-token"}'

curl https://api.linkbreakers.com/v1/integrations/contacts/CONTACT_TOOL_PIPEDRIVE/pipelines \
  -H "Authorization: Bearer $LINKBREAKERS_TOKEN"

curl -X PATCH https://api.linkbreakers.com/v1/integrations/contacts/CONTACT_TOOL_PIPEDRIVE \
  -H "Authorization: Bearer $LINKBREAKERS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"options": {"recordKind": "CONTACT_RECORD_KIND_DEAL", "pipelineId": "1", "stageId": "1", "recordTitle": "{link}: {name}"}}'
```

## When to use webhooks instead

The native connection writes persons, labels, leads and deals. To create organizations, assign an owner by territory, or add activities, use Pipedrive's own automations on new deals, or send [Linkbreakers webhooks](/help/article/how-do-webhooks-work-in-linkbreakers) to Zapier, Make or n8n and call Pipedrive from there.

## Limits and caveats

- **One Pipedrive company and one label per workspace**
- **Custom fields are matched by name**; option, people, monetary and address fields are not written
- **One open lead or deal per person**, by design
- **No marketing subscription** is set in Pipedrive
- **No retries.** A person Pipedrive refuses is reported as the last error on the page, not sent again
- **One way.** Nothing is read back from Pipedrive but labels, fields and pipelines

## Frequently asked questions

### Do I still need Zapier to send QR code leads to Pipedrive?

No. Linkbreakers creates Pipedrive persons, leads and deals directly with your API token.

### Will a visitor who fills two forms create two deals?

No. While the person has an open deal, no new deal or lead is created. A new one is created once the deal is won or lost.

### Can I sync visitors who only gave a phone number?

Yes. Pipedrive persons can be found and created by phone, so a visitor known only by phone is synced.

### Why does an answer not show on the person?

Pipedrive has no person field whose name matches the answer's key, or the field is of a type Linkbreakers does not write (options, people, money, address). Rename the field, or map the answer to it on the Pipedrive page.

### What happens when I disconnect Pipedrive?

Visitors stop being synced and the stored token is deleted. Persons, leads and deals already in Pipedrive stay there.

## Sources

- Linkbreakers Pipedrive integration page, API and MCP tools, checked in the product on 2026-11-09.
- Pipedrive API reference: https://developers.pipedrive.com/docs/api/v1

## Last reviewed

2026-11-09 by Laurent Schaffner.