Recall.ai API
API key for Recall.ai meeting notetaker bots.
Fields
| Field | Description | Required |
|---|---|---|
| API Key | Your Recall.ai API key from the dashboard (region-specific) | Yes |
| Region | The Recall.ai region your account was created in (us-west-2 default) | Yes |
| Default Bot Name | Display name the notetaker joins meetings with | No |
| Webhook Signing Secret | Svix signing secret from your Recall webhook endpoint; verifies bot-status webhooks | No |
Setup Steps
- Step 1: Sign in to your Recall.ai dashboard and copy an API key. Keys are region-specific — note which region your account was created in.
- Step 2: In Falcon Builder, go to Dashboard → Credentials → Add Credential and pick Recall.ai.
- Step 3: Paste the API key and select the matching region. Optionally set a default bot name — the display name the notetaker joins meetings with.
- Step 4: Click Test Credential. We list your bots against the selected region to confirm the key works.
Webhook setup (for the Meeting Ended trigger)
- In the Recall dashboard, open Webhooks → Add Endpoint and point it at
https://www.falconbuilder.dev/api/webhooks/recall/bot-status - Subscribe the endpoint to bot status-change events
- Copy the endpoint's signing secret (starts with
whsec_) into the credential's Webhook Signing Secret field so Falcon Builder can verify webhook origin
Without the webhook, Send Bot and Get Transcript still work — but the Meeting Ended trigger never fires, so transcripts must be fetched manually.