Use Fireflies.ai to list, search, retrieve, or delete meeting transcripts with an API key. Filter by keyword, host, participants, or time range; detailed reads include summaries, action items, topics, and participant analytics when available.
Upload audio or video files, or provide a media URL, for transcription with optional language, title, and attendee details. You can also add a bot to a live meeting and create soundbites from a transcript. The transcription-completed webhook starts a workflow when a new transcript is ready.
List, search, retrieve, or delete meeting transcripts, submit media for transcription, add a bot to a live meeting, and create soundbites. Transcription-completed webhooks can start workflows.
List meeting transcripts from Fireflies.ai with optional filtering
Parameter Type Required Description apiKeystring Yes Fireflies API key keywordstring No Search keyword in meeting title or transcript (e.g., "quarterly review") fromDatestring No Filter transcripts from this date (ISO 8601 format) toDatestring No Filter transcripts until this date (ISO 8601 format) hostEmailstring No Filter by meeting host email participantsstring No Filter by participant emails (comma-separated) limitnumber No Maximum number of transcripts to return (e.g., 10, max 50) skipnumber No Number of transcripts to skip for pagination (e.g., 0, 10, 20)
Parameter Type Description transcriptsarray List of transcripts countnumber Number of transcripts returned
Get a single transcript with full details including summary, action items, and analytics
Parameter Type Required Description apiKeystring Yes Fireflies API key transcriptIdstring Yes The transcript ID to retrieve (e.g., "abc123def456")
Parameter Type Description transcriptobject The transcript with full details ↳ id string Transcript ID ↳ title string Meeting title ↳ date number Meeting timestamp ↳ duration number Meeting duration in seconds ↳ transcript_url string URL to view transcript ↳ audio_url string URL to audio recording ↳ host_email string Host email address ↳ participants array List of participant emails ↳ speakers array List of speakers ↳ sentences array Transcript sentences ↳ summary object Meeting summary and action items ↳ analytics object Meeting analytics and sentiment
Get user information from Fireflies.ai. Returns current user if no ID specified.
Parameter Type Required Description apiKeystring Yes Fireflies API key userIdstring No User ID to retrieve (e.g., "user_abc123", defaults to API key owner)
Parameter Type Description userobject User information ↳ user_id string User ID ↳ name string User name ↳ email string User email ↳ integrations array Connected integrations ↳ is_admin boolean Whether user is admin ↳ minutes_consumed number Total minutes transcribed ↳ num_transcripts number Number of transcripts ↳ recent_transcript string Most recent transcript ID ↳ recent_meeting string Most recent meeting date
List all users within your Fireflies.ai team
Parameter Type Required Description apiKeystring Yes Fireflies API key
Parameter Type Description usersarray List of team users
Upload an audio file URL to Fireflies.ai for transcription
Parameter Type Required Description apiKeystring Yes Fireflies API key audioFilefile No Audio/video file to upload for transcription audioUrlstring No Public HTTPS URL of the audio/video file (MP3, MP4, WAV, M4A, OGG) titlestring No Title for the meeting/transcript webhookstring No Webhook URL to notify when transcription is complete languagestring No Language code for transcription (e.g., "es" for Spanish, "de" for German) attendeesstring No Attendees in JSON format: [{"displayName": "Name", "email": "email@example.com "}] clientReferenceIdstring No Custom reference ID for tracking
Parameter Type Description successboolean Whether the upload was successful titlestring Title of the uploaded meeting messagestring Status message from Fireflies
Delete a transcript from Fireflies.ai
Parameter Type Required Description apiKeystring Yes Fireflies API key transcriptIdstring Yes The transcript ID to delete (e.g., "abc123def456")
Parameter Type Description successboolean Whether the transcript was successfully deleted transcriptobject The deleted transcript ↳ id string Transcript ID ↳ title string Meeting title ↳ date number Meeting timestamp ↳ duration number Meeting duration ↳ host_email string Host email address ↳ organizer_email string Organizer email address
Add the Fireflies.ai bot to an ongoing meeting to record and transcribe
Parameter Type Required Description apiKeystring Yes Fireflies API key meetingLinkstring Yes Valid meeting URL (Zoom, Google Meet, Microsoft Teams, etc.) titlestring No Title for the meeting (max 256 characters) meetingPasswordstring No Password for the meeting if required (max 32 characters) durationnumber No Meeting duration in minutes (15-120, default: 60) languagestring No Language code for transcription (e.g., "en", "es", "de")
Parameter Type Description successboolean Whether the bot was successfully added to the meeting
Create a soundbite/highlight from a specific time range in a transcript
Parameter Type Required Description apiKeystring Yes Fireflies API key transcriptIdstring Yes ID of the transcript to create the bite from (e.g., "abc123def456") startTimenumber Yes Start time of the bite in seconds endTimenumber Yes End time of the bite in seconds namestring No Name for the bite (max 256 characters) mediaTypestring No Media type: "video" or "audio" summarystring No Summary for the bite (max 500 characters)
Parameter Type Description biteobject Created bite details ↳ id string Bite ID ↳ name string Bite name ↳ status string Processing status
List soundbites/highlights from Fireflies.ai
Parameter Type Required Description apiKeystring Yes Fireflies API key transcriptIdstring No Filter bites for a specific transcript (e.g., "abc123def456") mineboolean No Only return bites owned by the API key owner (default: true) limitnumber No Maximum number of bites to return (e.g., 10, max 50) skipnumber No Number of bites to skip for pagination (e.g., 0, 10, 20)
Parameter Type Description bitesarray List of bites/soundbites
List all contacts from your Fireflies.ai meetings
Parameter Type Required Description apiKeystring Yes Fireflies API key
Parameter Type Description contactsarray List of contacts from meetings
A trigger starts a workflow when a supported event occurs in this service.
Trigger workflow when a Fireflies meeting transcription is complete
Parameter Type Required Description webhookSecretstring No Secret key for HMAC signature verification (set in Fireflies dashboard)
Parameter Type Description meetingIdstring The ID of the transcribed meeting eventTypestring The type of event (e.g. Transcription completed, meeting.transcribed) clientReferenceIdstring Custom reference ID if set during upload timestampnumber Unix timestamp in milliseconds when the event was fired (V2 webhooks)