# Pipedrive

Connect Pipedrive so managers can build a practice persona from a deal,
with the deal's real context.

> [!NOTE]
> Early access: ask your Chambr contact to enable it for your account.

| | |
|---|---|
| Status | **Native · Early access** |
| Direction | Pipedrive → Chambr (read only) |
| Set up by | A Chambr manager, signing in to Pipedrive |
| Time | About 2 minutes |
| Data freshness | Read live when a manager opens the deal picker |

## What you need

- A Chambr manager (on the Integrations page, or from New persona). Managers pick deals once
  it's connected.
- A Pipedrive user who can install apps in your Pipedrive company and see the
  deals, organizations and people managers will use.
- Early access turned on for your Chambr account.

Chambr's Pipedrive app is a private app: it isn't listed in the Pipedrive
Marketplace. You install it by connecting from Chambr, which opens Pipedrive's
approval screen.

## What Chambr reads

| Pipedrive | Used for |
|---|---|
| Open deals: title, stage, value and currency | Choosing a deal, and the persona's situation |
| Pipeline stages: names | The stage shown on each deal |
| The deal's organization: name, industry and number of employees, where your account fills them in | The persona's company |
| Organization field settings: the option labels for industry and number of employees | Showing those as words, not option numbers |
| The deal's person: job title, where Pipedrive returns it | The persona's role |

Chambr reads when a manager opens the deal picker: up to 500 of your most
recently updated open deals and your stages, then the organizations and people
for the deals on screen. When the manager picks a deal, Chambr reads that deal
again. It never writes to Pipedrive, and it sees only the deals the Pipedrive
user who connected it can see.

## Permissions and scopes

| Scope | Why Chambr needs it |
|---|---|
| `base` | Required by every Pipedrive app |
| `deals:read` | List and read deals and their stages |
| `contacts:read` | Read the deal's organization and person, and the organization field labels |

## Set it up

### 1. Open Integrations in Chambr

In Chambr, open **Integrations** in the left nav and find **Pipedrive** under
CRM.

Managers can also connect from **Personas**: **New persona**, then
**Generate with AI**, then **From your CRM**.

### 2. Connect

Select **Connect**. Pipedrive asks you to sign in and approve Chambr's
access to your company. Approve it.

### 3. Back in Chambr

You return to where you started: the Pipedrive page under **Integrations**,
which shows **Connected**, or **New persona** if you connected from there.

## Verify it works

1. Go to **Personas**, select **New persona**, then **Generate with AI**, then
   **From your CRM**.
2. If more than one CRM is connected, pick **Pipedrive**. Your open deals are
   listed.
3. Pick one. Chambr drafts a persona from it for you to review.

## Limitations

- Chambr reads standard fields. Ask your Chambr contact about adding a custom field to the persona's context.
- The deal list shows your 500 most recently updated open deals. Search to
  find one that isn't listed.
- The deal owner isn't shown: Chambr doesn't ask for access to your Pipedrive
  users.
- The persona is written once from the deal; it doesn't change when the deal
  does.

## Troubleshooting

| Symptom | Cause | Fix |
|---|---|---|
| The card shows **Early access** and **Request access** | Not turned on for your account | Ask your Chambr contact |
| Pipedrive won't let you approve | You can't install apps in that Pipedrive company | Ask a Pipedrive admin to connect |
| The card says **Needs attention** | Pipedrive refused Chambr's access: the app was uninstalled, or the connection went unused for 60 days | Disconnect, then connect again |

## Disconnect

On the **Integrations** page, select **Disconnect** on the Pipedrive card and
confirm. Chambr deletes its stored access; personas you already created stay.
To also remove Chambr on the Pipedrive side, uninstall it from your installed
apps under **Tools and apps** in Pipedrive.
