---
title: "Connect Breezy HR to Metaintro | Metaintro"
canonical: "https://www.metaintro.com/help/connect-breezy-to-metaintro"
language: "en"
author: "Metaintro"
published: "2026-11-11T16:02:20.074Z"
modified: "2026-11-11T16:02:37.871Z"
---

# Connect Breezy HR to Metaintro

Send candidates who chose to share with you straight into Breezy HR, and get their stage changes back in Metaintro.

Last updated: November 11, 2026[Employers](/help/category/employers)

Paste it into Claude, ChatGPT, Codex, Cursor or Pi.

## Before you start

- Your Breezy plan needs Breezy's Developer API. If it doesn't have it, Breezy refuses the connection.
- Each user creates personal API keys in their own settings. Breezy's docs don't name a role for this. The key acts as the user who creates it, so use a user who can see the positions you want to connect.
- Instant stage updates use webhooks, which need a Breezy Pro plan.
- You'll paste two things into Metaintro: a personal access token and your Breezy company ID.

## Create the credential in Breezy

These steps follow Breezy's guide, [Authorization](https://developer.breezy.hr/reference/authorization).

1. In Breezy, select your user icon in the lower left.
2. Go to **My Settings** and open the **API Keys** tab.
3. Select **Create API Key** and give it a name, such as "Metaintro".
4. Copy the token straight away. Breezy only shows it once.

Breezy doesn't show your company ID on a settings screen. Breezy's [Customer Guide](https://developer.breezy.hr/reference/customer-guide) explains how to look it up through Breezy's API with the token you just made. If you're not comfortable doing that, ask whoever manages your Breezy integrations.

## Connect in Metaintro

1. In Metaintro, go to **Settings > Integrations** and choose **Breezy HR**.
2. In **Personal access token**, paste the token.
3. In **Company ID**, paste your company ID.
4. Select **Connect**.

To get stage changes straight away on a Pro plan, set up a webhook:

1. Copy the **Webhook address** that Metaintro shows after you connect.
2. Breezy creates webhooks through its API, not a settings screen. Follow Breezy's [Customer Guide](https://developer.breezy.hr/reference/customer-guide) to create a webhook with that address and the candidate status updated event.
3. Breezy returns a secret that starts with "whsec_". It's only shown once.
4. Back in Metaintro, paste it into **Signing token** and select **Save token**.

## What Metaintro sends and reads

Metaintro only sends people who chose to share their profile with you for a specific job. For each person, Metaintro:

- adds them to the position you linked as a sourced candidate, with "Metaintro" as the source, or finds the existing candidate on that position with exactly the same email address
- uploads their résumé when they shared one
- adds a note to the candidate's activity with a link to their proof card

Stage changes come back to Metaintro through the webhook. Metaintro also checks Breezy regularly, so changes still arrive without a webhook. Metaintro can also move a candidate to the pipeline stage that matches, such as an interview or offer stage.

## Limits

- Breezy allows 100 API requests per minute for each token. Metaintro paces its requests to stay under that, so large batches take a few minutes.
- Webhooks need a Breezy Pro plan. Each Breezy account can have up to 10 webhook endpoints.
- In Breezy, a candidate belongs to one position. When the same person is shared for two positions, Breezy holds two candidate records.
- Moving a candidate only works when your pipeline has a stage that matches, such as "Interviewing" or "Offered".

## If something goes wrong

- **The token is rejected.** Check that you copied the whole token. If you lost it, create a new API key in **My Settings > API Keys** and connect again.
- **Access is refused.** Your plan may not include the Developer API, or the user who made the token isn't a member of that company. Check the company ID and your plan with Breezy.
- **Stage updates are slow.** Check that your plan is Pro, that the webhook exists, and that the signing token in Metaintro matches the secret Breezy gave you.
- **Rate limited.** Metaintro waits and tries again on its own. If it keeps happening, check whether other tools use the same token.

### Was this article helpful?

## Related Articles

- [Connect your ATS to MetaintroSend people who choose to share with you straight into your applicant tracking system, and see their stage in Metaintro.](/help/connect-your-ats-to-metaintro)

[Return to navigation](#main-navigation)