> For the complete documentation index, see [llms.txt](https://docs.praiz.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.praiz.io/integrations/connect-your-crm/planhat.md).

# Connect Planhat

Connect Planhat to Praiz: structured notes on Companies and End-users after every call.

## Before you start

* A Planhat admin to create the API token.
* A Planhat account for each user, with the same email address as in Praiz.
* Planhat records created before the conversations.
* The rules common to every CRM are on the [Connect your CRM](https://docs.praiz.io/integrations/connect-your-crm.md) page.

## Connect Planhat

The Planhat connection is made user by user, with a shared API token.

### Step 1: create the API token in Planhat (admin)

1. In Planhat, open "App Center", then "Private apps".
2. Create a private app named Praiz. In "Copy permissions from", choose "Administrator".
3. Click "Generate a new token" and keep the token.

The same token is used by every user.

### Step 2: connect Planhat in Praiz (each user)

1. Open "Settings", "Integrations" tab.
2. On the "CRM" card, click "Connect" and select Planhat.
3. Paste the token.

What to expect: the "CRM" card shows "Connected". The "CRM Connection" column of "Users & Teams" shows Planhat for that user.

## What Praiz writes

| Planhat object               | Supported |
| ---------------------------- | --------- |
| Conversations (notes)        | Yes       |
| End-users                    | Yes       |
| Companies                    | Yes       |
| Activities (calls, meetings) | No        |

Praiz only writes notes to Planhat. Praiz does not fill in Planhat fields.

You choose the content of the note in each agent, "Fields" tab, with "Push to CRM notes". See [CRM sync](https://docs.praiz.io/automate/crm-sync.md).

## Writing rules

Praiz adds a note. Praiz never erases existing data in Planhat. The detailed rules are on the [Connect your CRM](https://docs.praiz.io/integrations/connect-your-crm.md) page.

## Automatic and manual sync

Praiz sends the note when an agent applies to a call under its automation rules, or when you click "Send to CRM" on the call page. The details are on the [Connect your CRM](https://docs.praiz.io/integrations/connect-your-crm.md) page.

## Troubleshooting

When a note is not sent, Praiz tells you why instead of staying silent.

* The Company was created after the conversation: Praiz does not resync past conversations.
* The End-user's email or the phone number format does not exactly match the Planhat record: the note is not attached.
* The user has not connected their account: the Planhat connection is per user. Check the "CRM Connection" column of "Users & Teams".
* The token is no longer valid in Planhat: create a new token and redo step 2.

## Related pages

* [Connect your CRM](https://docs.praiz.io/integrations/connect-your-crm.md)
* [CRM sync](https://docs.praiz.io/automate/crm-sync.md)
* [My notes don't show up in my CRM](https://docs.praiz.io/troubleshooting/my-notes-dont-show-up-in-my-crm.md)
