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.
In Breezy, select your user icon in the lower left.
Go to My Settings and open the API Keys tab.
Select Create API Key and give it a name, such as "Metaintro".
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 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
In Metaintro, go to Settings > Integrations and choose Breezy HR.
In Personal access token, paste the token.
In Company ID, paste your company ID.
Select Connect.
To get stage changes straight away on a Pro plan, set up a webhook:
Copy the Webhook address that Metaintro shows after you connect.
Breezy creates webhooks through its API, not a settings screen. Follow Breezy's Customer Guide to create a webhook with that address and the candidate status updated event.
Breezy returns a secret that starts with "whsec_". It's only shown once.
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.