Where
Integrations→Integrations→Apps & CRM
Your role needs
Read access to Apps & CRM
read-integrations. Admin, Member and Viewer have it by default.To create or change
create-integrations to add one, update-integrations to change one, on top of the permission above.If you cannot find this in your sidebar, your workspace may have a custom menu configuration. Contact support and we will check it for you.
Before you begin
- An account with whichever one of the three you already book through. You only need one; nothing here needs all three connected at once.
- For Cal.com or Brevo, permission in that account to generate an API key. Calendly instead asks you to sign in and approve access, with no key involved.
- For Brevo, one manual step in Brevo’s own dashboard partway through, covered below.
Steps
1
Open the connector list
Go to and choose Add integration. Calendly, Cal.com and Brevo are the first three entries in the list, above the CRM connectors. Pick whichever one you use.
2
Connect Calendly
Choosing Calendly opens no dialog. Your browser leaves the app for Calendly, where you sign in and approve access. Approving it brings you back to (the settings tab, even though you started on the sidebar) with a toast confirming the connection, and a webhook subscription is requested on your Calendly account in the same round trip.That toast confirms the sign-in, not the webhook. Only a failed sign-in produces an error toast: a webhook subscription Calendly refused still lands you on a success toast, and only shows up afterwards as a warning chip on the card.
3
Connect Cal.com
Choosing Cal.com opens a dialog with a six-step panel for finding your API key in Cal.com’s own settings, and a field to paste it into underneath.The panel (1) walks through Cal.com’s own account settings; the field to paste the result into (2) sits underneath it. Only a key starting with
cal_ is accepted; anything else is refused in the dialog, before it is sent anywhere.Paste a real one and choose Connect. The key is checked against your Cal.com account and stored, and a webhook subscription is created on Cal.com in the same request. If that works, the dialog reads Integration Complete!. If it does not, the dialog reads Connected with Limited Functionality, carrying Cal.com’s own reason where one came back. The account is connected either way; what is missing is the webhook, and without it no booking ever reaches the app.4
Connect Brevo
Choosing Brevo opens a similar dialog, but Brevo has no API for creating a meeting webhook, so this connection takes one extra step that you do yourself.The panel (1) walks through Brevo’s own account settings; the field (2) is underneath it. Only a key starting with
xkeysib- is accepted.Paste it and choose Next. The key is checked against your Brevo account, and the dialog moves to a second step showing a webhook URL to copy. Open Brevo yourself, add an outbound webhook under Meetings → Settings → Webhooks with that URL, set its event category to Meetings, and turn on the Meeting booked event. Turn on nothing else: a Brevo webhook that arrives with participants on it is read as a booking, whatever event sent it.Back in the dialog, choose Done, then, once the button changes, Yes, I created it!. The first click only asks you to confirm; the second is what marks the connection ready. Until it is, the card carries a Finish setup chip.What happens next
The connector’s card on shows a Connected chip, with the account’s own email under its name. Where the service returned no email, the card shows the date you connected it instead.
Troubleshooting
'Invalid Cal.com API key' or 'Invalid Brevo API key'
'Invalid Cal.com API key' or 'Invalid Brevo API key'
The key had the right prefix (
cal_ or xkeysib-), so it was sent on to be checked against your account there, and the service refused it. Copy a fresh key straight from Cal.com’s or Brevo’s own settings page rather than retyping it, and confirm it has not been revoked since you copied it.The card shows a warning chip
The card shows a warning chip
What it means depends on the connector. Calendly’s “Require attention” is the tooltip’s fallback when Calendly sent no error of its own, and it points at the usual cause: the account is not on Calendly’s Standard plan. Cal.com’s “Limited functionality” means the automatic webhook subscription failed; hover the chip for Cal.com’s own reason, where it gave one. Brevo’s Finish setup means the manual webhook step in Brevo’s dashboard has not been confirmed yet. Click it to reopen the dialog where you left off.
A meeting was booked, but the lead's stage never changed
A meeting was booked, but the lead's stage never changed
A booking only moves a lead that is already in this workspace and that one of the booking’s own addresses reaches. The exact address is tried first. The fallback on its domain is skipped for personal mail domains, and otherwise only reaches leads that are not Closed and have at least one message on record, so a booking from a colleague at a company you have never written to matches nothing. When nothing matches, no lead is created and nothing is logged where you could see it.
Related
Meetings overview
The product’s own meeting links, for booking without ever leaving the app.
Lead stages and the funnel view
The six fixed stages, and what else moves a lead between them.
Calendar connections
A different connection: your own calendar, used to check conflicts and place bookings from a meeting link.