| name | fireflies-webhooks-events |
| description | Implement Fireflies.ai webhook receiver with HMAC signature verification and event processing.
Use when setting up webhook endpoints, handling transcript-ready notifications,
or building real-time meeting intelligence pipelines.
Trigger with phrases like "fireflies webhook", "fireflies events",
"fireflies webhook signature", "handle fireflies events", "fireflies notifications".
|
| allowed-tools | Read, Write, Edit, Bash(curl:*) |
| version | 1.11.0 |
| license | MIT |
| author | Jeremy Longshore <jeremy@intentsolutions.io> |
| tags | ["saas","fireflies","webhooks"] |
| compatibility | Designed for Claude Code, also compatible with Codex and OpenClaw |
Fireflies.ai Webhooks & Events
Overview
Handle Fireflies.ai webhook events for real-time transcript notifications. Fireflies fires a webhook when a transcript finishes processing. The payload is signed with HMAC-SHA256 for verification.
Prerequisites
- Fireflies.ai Business or Enterprise plan
FIREFLIES_API_KEY and FIREFLIES_WEBHOOK_SECRET in environment
- HTTPS endpoint accessible from the internet
Webhook Event Reference
Fireflies currently fires one event type:
| Event | eventType Value | Trigger |
|---|
| Transcription completed | "Transcription completed" | Transcript is fully processed and ready |
Payload Format
{
"meetingId": "ASxwZxCstx",
"eventType": "Transcription completed",
"clientReferenceId": "be582c46-4ac9-4565-9ba6-6ab4264496a8"
}
| Field | Type | Description |
|---|
meetingId | String | Transcript ID -- use in transcript(id:) query |
eventType | String | Always "Transcription completed" currently |
clientReferenceId | ID | Your custom ID from uploadAudio (null if bot-recorded) |
Important Constraints
- Webhooks fire only for meetings you own (organizer_email matches your account)
- Super Admin webhooks (Enterprise only) fire for all team-owned meetings
Instructions
Step 1: Register Webhook in Dashboard