---
title: "Linkbreakers + Paperform: branded QR landing forms with each answer on the visitor"
description: "Connect Paperform with an API key and every Paperform behind your links and QR codes brings its submissions to the exact visitor who scanned, matched through a hidden lbid field, with their email, name, phone and answers. Setup, the Business API plan and the manual webhook, what is synced, and the Assistant and MCP tools."
canonical: "https://linkbreakers.com/help/article/linkbreakers-paperform-integration-branded-qr-landing-forms"
last-updated: 2026-11-09
---

# Linkbreakers + Paperform: branded QR landing forms with each answer on the visitor

> Connect Paperform with an API key and every Paperform behind your links and QR codes brings its submissions to the exact visitor who scanned, matched through a hidden lbid field, with their email, name, phone and answers. Setup, the Business API plan and the manual webhook, what is synced, and the Assistant and MCP tools.

:::try-ai-prompt {"prompt":"Check my Paperform forms again and tell me which ones still need something from me","description":"Check your Paperform forms with the Assistant.","target":"assistant"}:::

## Short answer

Linkbreakers connects to Paperform directly. In the dashboard, open **Integrations**, pick **Paperform**, paste your Paperform API key and select **Connect Paperform**. Linkbreakers then finds every Paperform your links redirect to and adds its webhook to each one. You add one Hidden field with the pre-fill key `lbid` to each form. When someone scans your QR code, the redirect carries their visit ID into that field, and when they submit, the submission is added to that exact visitor: email, name, phone and every other answer.

Paperform's API cannot add fields, so the hidden field is the one step you do by hand. Creating webhooks through the API needs Paperform's Business API plan; without it, you paste one webhook address in each form instead. The integration is available on every Linkbreakers plan.

## Quick summary

- Connect once per workspace with a Paperform API key
- Paperforms behind your links are found automatically from the [redirect steps](/workflow-steps/redirect) of your workflows
- You add a Hidden field with the pre-fill key `lbid` to each form; Linkbreakers checks it is there
- Linkbreakers adds its webhook to each form when your Paperform plan includes the Business API; otherwise the page gives you the address to paste
- Each submission is matched to the exact visit that opened the form, not guessed from timing
- Email, first name, last name and phone go to the visitor's standard fields; other answers become visitor attributes named after the question
- Submissions come in as soon as the form is submitted
- Submissions with no visit ID, such as a form opened directly, are skipped and counted
- Also managed from the Assistant, the MCP server or the REST API

## How it works

1. You connect Paperform. Linkbreakers looks at the redirect steps of your links' workflows and picks up every destination on a `<form>.paperform.co` address.
2. For each of those forms, Linkbreakers checks for a field whose pre-fill key is `lbid`. If it is missing, the form asks you to add it.
3. Linkbreakers adds its webhook to the form, triggered on each submission. If Paperform answers that the Business API is not on your plan, the form shows the webhook address for you to paste instead.
4. When someone goes through the link, the redirect adds `lbid=<visit ID>` to the form address, and Paperform fills the hidden field from it.
5. When they submit, Paperform sends the submission to Linkbreakers. The secret in the webhook address is what proves a request; anything else is refused.
6. Linkbreakers reads the `lbid` field, finds the visit, and adds the answers to that visitor.

Once a day, Linkbreakers checks the forms again: a webhook it created and you removed is put back, and a form no longer behind a covered link loses the webhook Linkbreakers created.

## Connect Paperform

1. In Paperform, open **Account**, then **Developer**, and copy your API key.
2. In Linkbreakers, open **Integrations** in the dashboard and pick **Paperform**.
3. Paste the key in **API key** and select **Connect Paperform**. Linkbreakers checks the key against Paperform before storing it, and the forms behind your links are prepared at once.
4. Check **Forms found**. Each form shows the link it is behind and a green check when it is ready.
5. For a form that says "Add a Hidden field to this form in Paperform, with lbid as its pre-fill key.", open it in Paperform, add a Hidden field, set its pre-fill key to `lbid`, and publish.
6. For a form that says "Paste this webhook address in the form's settings, under Webhooks:", copy the address shown (select it to copy) and add it as a webhook in that form's settings in Paperform.
7. Select **Check forms again** to confirm the hidden field. A form whose webhook you pasted can keep showing the address, since without the Business API Linkbreakers cannot check that webhook through Paperform's API.
8. Optionally, set **Where** and **What comes in**, then save.

The key is encrypted when it is stored and never shown again.

To have a new form picked up, add a redirect to it in a link's workflow. Then select **Check forms again**, or wait for the daily check.

## What gets synced

| Paperform answer | Linkbreakers visitor |
|---|---|
| Question whose title contains "email", "e-mail" or "courriel" | Email |
| Title containing "first name", "firstname", "prénom", "prenom" or "given name" | First name |
| Title containing "last name", "lastname", "nom de famille", "family name" or "surname" | Last name |
| Title containing "phone", "téléphone", "telephone", "mobile" or "cell" | Phone |
| Any other answered question | A visitor attribute named after the question title, or its pre-fill key when it has no title |

A question titled only "Name" or "Full name" is not split into first and last name: it is kept as an attribute with that title. Empty answers are left out, and the `lbid` field itself is not stored as an answer.

## Which visitors and which links

The Paperform page has the settings Linkbreakers integrations share, adapted to answers coming in:

- **Where**: **All links**, or **Selected links**, directories and tags. Only the forms of the links you choose are prepared, and only their submissions are added to visitors.
- **When**: as soon as someone submits the form. There is nothing to choose.
- **What comes in**: **Every answer**, or **Only some answers**, where you pick the fields to keep, such as Email and Phone.

A submission is skipped, and counted under **Skipped** on the page, when it has no visit ID (the form was opened directly, not through your link, or the hidden field is missing), when the visit belongs to another workspace, when it came through a link outside **Where**, or when none of its answers are among those you chose to keep.

The **Activity** section shows **Responses**, **Visitors enriched**, **Skipped** and **Last response**.

## Pause and disconnect

**Pause** stops submissions from coming in: links stop adding the visit ID, and submissions that arrive are ignored. **Activate** turns it back on.

**Disconnect** stops submissions and removes the webhooks Linkbreakers created. A webhook you pasted yourself is not removed: delete it in Paperform. The hidden `lbid` field stays in your forms, and answers already added to visitors stay on them.

In a link's workflow, a redirect to a Paperform shows the Paperform logo when its submissions are coming in, or a card that says **Not connected** or **Not syncing** with a button to fix it.

## Manage it from the Assistant, MCP or the API

Connecting needs you in the app, to paste the API key. Everything after that can be done by an agent.

**Assistant**: in the dashboard, ask "Which of my Paperforms still need the lbid field?" or "Give me the webhook address for Paperform".

**MCP server**: an agent connected to the [Linkbreakers MCP server](/help/article/mcp-server-setup) has `form_integrations_list`, `form_integration_get`, `form_integration_forms_list`, `form_integration_forms_prepare`, `form_integration_update` and `form_integration_disconnect`, with the tool `PAPERFORM`. The connection's `webhook_url` is the address to paste.

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

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

curl https://api.linkbreakers.com/v1/form-integrations/FORM_TOOL_PAPERFORM/forms \
  -H "Authorization: Bearer $LINKBREAKERS_TOKEN"
```

## Limits and caveats

- **One Paperform account per workspace**
- **You add the hidden field.** Paperform's API cannot add fields, so each form needs a Hidden field with the pre-fill key `lbid` before its submissions can be matched
- **Webhooks through the API need Paperform's Business API plan.** Without it you paste the webhook address in each form, and Linkbreakers cannot add, check or remove that webhook for you
- **Only forms behind a redirect step** in a link's workflow are prepared. A form you share by other means brings nothing in
- **Only `<form>.paperform.co` addresses** are recognized. Paperforms on a custom domain are not
- **Submissions without a visit ID are skipped**, for example when someone opens the form from a bookmark or a forwarded address
- **One way.** Submissions come into Linkbreakers; nothing is written back to Paperform except the webhook

## Frequently asked questions

### Do I still need Zapier to get Paperform submissions on my QR code visitors?

No. Linkbreakers receives Paperform submissions directly through its own webhook and adds them to the visitor who scanned.

### Why do I have to add the hidden field myself?

Paperform's API can read a form's fields but not add one. Linkbreakers checks every form for the `lbid` field and tells you which ones still need it.

### Do I need Paperform's Business API plan?

No, but without it Linkbreakers cannot create the webhook for you. The Paperform page then gives you one address to paste in each form's webhook settings.

### How does Linkbreakers know which visitor filled the form?

The redirect puts the visit ID in the form's `lbid` hidden field. Paperform sends it back with the submission, so the match is exact, even when many people scan at the same time.

### What happens when I disconnect Paperform?

Submissions stop coming in and the webhooks Linkbreakers created are removed. Remove any webhook you pasted yourself in Paperform. Answers already on visitors stay.

## Sources

- Linkbreakers Paperform integration page, API and MCP tools, checked in the product on 2026-11-09.
- Paperform API documentation: https://paperform.readme.io

## Last reviewed

2026-11-09 by Laurent Schaffner.