Fireflies.ai

Actions

Action	What it does
Add live action item	Add an action item to a meeting that is happening now, described in plain words for Fireflies' assistant to write up.
Add member to user group	Add a teammate to a user group by email.
Ask Fred	Ask Fireflies' AI assistant a question about one meeting, or about every meeting that matches the filters (by default the last 30 days, and never more than a year back).
Ask Fred a follow-up	Ask a follow-up question in an Ask Fred conversation, which keeps the earlier questions and answers in mind.
Change who can see a meeting	Set who can open a meeting's notes and recording in Fireflies.
Clip live soundbite	Clip a soundbite from a meeting that is happening now, described in plain words, such as 'the pricing discussion'.
Create soundbite	Clip part of a meeting's recording as a soundbite to share.
Delete Ask Fred conversation	Permanently delete an Ask Fred conversation and its messages.
Delete meeting	Permanently delete a meeting with its recording, transcript and notes.
Get Ask Fred conversation	Get an Ask Fred conversation with every question and answer in it.
Get channel	Get one channel's name, privacy and members.
Get meeting	Get one meeting's details: who organized and attended it, when each person joined and left, who spoke, who can see it, its channel and whether its notes are ready.
Get meeting analytics	Get a meeting's conversation analytics: how positive or negative it was, how many questions, dates, metrics and tasks came up, and each speaker's talk time, word count, pace and filler words.
Get meeting summary	Get the AI-generated notes for one meeting, including a written overview, the action items, the key topics, an outline, a one-line gist and the meeting type.
Get meeting transcript	Get the full word-for-word transcript of one meeting, as a single speaker-labelled text block and as individual timestamped lines.
Get recording links	Get download links for a meeting's audio and, if video recording is on in Fireflies, its video.
Get soundbite	Get one soundbite: its clip and thumbnail links, captions, summary and processing status.
Get team analytics	Get the team's meeting and conversation figures for a period: meeting counts and time, talk-to-listen ratio, questions, filler words, sentiment, and the same per team member.
Get team member	Get one team member's details and user groups.
List active meetings	List the meetings the Fireflies notetaker is in right now, with their IDs for the live meeting actions.
List AI app outputs	List what your Fireflies AI apps (custom prompts run on each meeting, such as 'Sales call scorecard') wrote, for one meeting, one app, or both.
List Ask Fred conversations	List the API key owner's Ask Fred conversations.
List channels	List the channels (folders that meetings are filed in) the API key's owner can see: every public channel and the private ones they belong to.
List contacts	List the people the API key's owner has met with, with the date of their last meeting together.
List live action items	List the action items so far in a meeting that is happening now, both those Fireflies noticed and those added with Add live action item.
List meetings	List the meetings Fireflies.ai has recorded and transcribed, newest first.
List soundbites	List soundbites (short clips cut from meetings): yours, your team's, or one meeting's. With nothing chosen it lists yours.
List team members	List the people in your Fireflies.ai workspace, with how many meetings each has recorded.
List user groups	List the team's user groups and their members.
Move meetings to a channel	File up to 5 meetings in a channel (a Fireflies folder).
Pause or resume recording	Pause or resume the Fireflies notetaker's recording in a meeting that is happening now.
Remove member from user group	Remove a teammate from a user group by email.
Rename meeting	Change a meeting's title.
Send notetaker to a meeting	Send the Fireflies.ai notetaker into a meeting that is happening now, so it records and transcribes the call.
Set team member's role	Make a team member an admin or a regular member.
Share meeting	Share a meeting with up to 50 people by email, even outside your team, for good or for 7, 14 or 30 days.
Stop sharing meeting	Take back one person's access to a meeting that was shared with them.
Transcribe a recording	Send an audio or video recording to Fireflies.ai to be transcribed.

Add an action item to a meeting that is happening now, described in plain words for Fireflies' assistant to write up. Only the meeting's organizer or a team admin can do this, Fireflies allows 10 an hour, and each one spends AI credits.

Inputs

Meeting IDmeeting_idtextRequired: The live meeting's ID: the 'id' of a List active meetings result.
Action itemprompttextRequired: What needs doing, in 5 to 255 characters, such as 'James sends the revised quote by Friday'.

Outputs

successtrue/false: Whether Fireflies did it.

Example output

{
  "success": true
}

Add member to user group

Add a teammate to a user group by email. Needs a team admin's API key and a Fireflies Business plan or higher.

Inputs

User groupgroup_idtextRequired: The user group. Pick one, or give its ID.
Team member's emailemailtextRequired: The email address of someone on your Fireflies team.

Outputs

handletext
idtext
memberslist
nametext

Example output

{
  "handle": "sales",
  "id": "grp_sales",
  "members": [
    {
      "email": "sarah@example.com",
      "first_name": "Sarah",
      "last_name": "Chen",
      "name": "Sarah Chen",
      "user_id": "01HXUSER000000000000000"
    }
  ],
  "name": "Sales"
}

Ask Fred

Ask Fireflies' AI assistant a question about one meeting, or about every meeting that matches the filters (by default the last 30 days, and never more than a year back). Returns the answer and a thread ID for follow-up questions. Spends Fireflies AI credits.

Inputs

QuestionquestiontextRequired: What to ask, up to 2,000 characters, such as 'What objections did customers raise this week?'
Meeting IDmeeting_idtext: Ask about this meeting only. Leave blank to ask across meetings, narrowed by the filters below.
From datestart_datedate and time: Only meetings on or after this date, up to a year back.
To dateend_datedate and time: Only meetings on or before this date and time.
Meeting IDsmeeting_idslist: Only these meetings.
Channel IDschannel_idslist: Only meetings in these channels.
Organizer emailsorganizer_emailslist: Only meetings organized by these addresses.
Participant emailsparticipant_emailslist: Only meetings these addresses attended.
Answer languagelanguagetext: Answer in this language, as a code such as 'en' or 'es'. Leave blank to answer in the question's language.
Answer formatanswer_formattext: Markdown keeps headings and lists; plain text has none.One of: markdown, plaintext (Plain text).
Suggest follow-up questionssuggest_follow_upstrue/false: Also suggest follow-up questions. The answer takes longer.

Outputs

answertext: AskFred's answer.
costnumber: AI credits used.
created_attext
message_idtext
querytext: The question that was asked.
statustext: processing, completed or failed.
suggested_querieslist: Follow-up questions, when they were asked for.
thread_idtext: The conversation's ID, for follow-up questions.

Example output

{
  "answer": "The release ships on 1 August, after the design review on Thursday.",
  "cost": 1.0,
  "created_at": "2026-07-15T10:30:00Z",
  "message_id": "msg_001",
  "query": "What did we decide about the release?",
  "status": "completed",
  "suggested_queries": [],
  "thread_id": "thread_abc123"
}

Ask Fred a follow-up

Ask a follow-up question in an Ask Fred conversation, which keeps the earlier questions and answers in mind. Spends Fireflies AI credits.

Inputs

Thread IDthread_idtextRequired: The conversation's ID: the 'thread_id' of an Ask Fred result.
QuestionquestiontextRequired: The follow-up question, up to 2,000 characters.
Answer languagelanguagetext: Answer in this language, as a code such as 'en' or 'es'. Leave blank to answer in the question's language.
Answer formatanswer_formattext: Markdown keeps headings and lists; plain text has none.One of: markdown, plaintext (Plain text).
Suggest follow-up questionssuggest_follow_upstrue/false: Also suggest follow-up questions. The answer takes longer.

Outputs

answertext: AskFred's answer.
costnumber: AI credits used.
created_attext
message_idtext
querytext: The question that was asked.
statustext: processing, completed or failed.
suggested_querieslist: Follow-up questions, when they were asked for.
thread_idtext: The conversation's ID, for follow-up questions.

Example output

{
  "answer": "James Lee owns the design review on Thursday.",
  "cost": 1.0,
  "created_at": "2026-07-15T10:31:00Z",
  "message_id": "msg_002",
  "query": "Who owns the design review?",
  "status": "completed",
  "suggested_queries": [],
  "thread_id": "thread_abc123"
}

Change who can see a meeting

Set who can open a meeting's notes and recording in Fireflies. Only the meeting's owner or a team admin can do this.

Inputs

Meeting IDmeeting_idtextRequired: The meeting's ID: the 'id' of a List meetings result.
Who can see itprivacytextRequired: Who can open the meeting.One of: link (Anyone with the link), owner (Only the owner), participants, teammatesandparticipants (Teammates and participants), teammates, participatingteammates (Teammates who took part (beta)).

Outputs

idtext
privacytext
titletext

Example output

{
  "id": "01HXAMPLE0000000000000000",
  "privacy": "teammates",
  "title": "Weekly Standup"
}

Clip live soundbite

Clip a soundbite from a meeting that is happening now, described in plain words, such as 'the pricing discussion'. Only the meeting's organizer or a team admin can do this, Fireflies allows 10 an hour, and each one spends AI credits.

Inputs

Meeting IDmeeting_idtextRequired: The live meeting's ID: the 'id' of a List active meetings result.
What to clipprompttextRequired: What the clip should capture, in 5 to 255 characters.

Outputs

successtrue/false: Whether Fireflies did it.

Example output

{
  "success": true
}

Create soundbite

Clip part of a meeting's recording as a soundbite to share. Fireflies makes the clip in the background: its status is 'ready' when it can be played.

Inputs

Meeting IDmeeting_idtextRequired: The meeting's ID: the 'id' of a List meetings result.
Start timestart_timenumberRequired: Where the clip starts, in seconds from the start of the meeting. A transcript line's 'start_time' works.At least 0.
End timeend_timenumberRequired: Where the clip ends, in seconds from the start.At least 0.
Namenametext: The clip's title, up to 256 characters.
Summarysummarytext: A description, up to 500 characters.
Mediamedia_typetext: Video or audio only.One of: video, audio.
Who can see itprivacieslist: Leave blank for Fireflies' default.One or more of: public (Anyone with the link), team (Teammates), participants (Meeting participants).

Outputs

captionslist
created_attext
created_byobject
end_timenumber: Seconds from the start of the meeting.
idtext
media_typetext: video or audio.
meeting_idtext
nametext
previewtext
privacieslist: Who can see it.
sourceslist: Where to play the clip.
start_timenumber: Seconds from the start of the meeting.
statustext: pending, processing, ready or error.
summarytext
thumbnailtext

Example output

{
  "captions": [
    {
      "end_time": 3.2,
      "speaker_name": "Sarah Chen",
      "start_time": 0.5,
      "text": "Let's start with the release timeline."
    }
  ],
  "created_at": "2026-07-15T10:00:00.000Z",
  "created_by": {
    "id": "01HXUSER000000000000000",
    "name": "Sarah Chen"
  },
  "end_time": 6.1,
  "id": "01HXBITE00000000000000000",
  "media_type": "video",
  "meeting_id": "01HXAMPLE0000000000000000",
  "name": "Release timeline",
  "preview": "https://cdn.fireflies.ai/bites/preview.mp4",
  "privacies": [
    "team"
  ],
  "sources": [
    {
      "type": "video/mp4",
      "url": "https://cdn.fireflies.ai/bites/clip.mp4"
    }
  ],
  "start_time": 0.5,
  "status": "pending",
  "summary": "Sarah sets the release timeline.",
  "thumbnail": "https://cdn.fireflies.ai/bites/thumb.jpg"
}

Delete Ask Fred conversation

Permanently delete an Ask Fred conversation and its messages. The meetings it was about are not touched.

Inputs

Thread IDthread_idtextRequired: The conversation's ID: the 'thread_id' of an Ask Fred result.

Outputs

deletedtrue/false
idtext
titletext

Example output

{
  "deleted": true,
  "id": "thread_abc123",
  "title": "What did we decide about the release?"
}

Delete meeting

Permanently delete a meeting with its recording, transcript and notes. This cannot be undone. You can delete your own meetings; deleting a teammate's needs a team admin. Fireflies allows 10 deletions a minute.

Inputs

Meeting IDmeeting_idtextRequired: The meeting's ID: the 'id' of a List meetings result.

Outputs

datetext
deletedtrue/false
idtext
titletext

Example output

{
  "date": "2026-07-15T09:00:00Z",
  "deleted": true,
  "id": "01HXAMPLE0000000000000000",
  "title": "Weekly Standup"
}

Get Ask Fred conversation

Get an Ask Fred conversation with every question and answer in it.

Inputs

Thread IDthread_idtextRequired: The conversation's ID: the 'thread_id' of an Ask Fred result.

Outputs

created_attext
idtext
meeting_idtext: The meeting it is about, if just one.
messageslist: The questions and answers, in order.
titletext: Taken from the first question.
user_idtext

Example output

{
  "created_at": "2026-07-15T10:30:00Z",
  "id": "thread_abc123",
  "meeting_id": "01HXAMPLE0000000000000000",
  "messages": [
    {
      "answer": "The release ships on 1 August, after the design review on Thursday.",
      "created_at": "2026-07-15T10:30:00Z",
      "message_id": "msg_001",
      "query": "What did we decide about the release?",
      "status": "completed",
      "suggested_queries": [],
      "thread_id": "thread_abc123"
    },
    {
      "answer": "James Lee owns the design review on Thursday.",
      "created_at": "2026-07-15T10:31:00Z",
      "message_id": "msg_002",
      "query": "Who owns the design review?",
      "status": "completed",
      "suggested_queries": [],
      "thread_id": "thread_abc123"
    }
  ],
  "title": "What did we decide about the release?",
  "user_id": "01HXUSER000000000000000"
}

Get channel

Get one channel's name, privacy and members.

Inputs

Channelchannel_idtextRequired: The channel (folder). Pick one, or give a channel's ID.

Outputs

created_attext
created_bytext: Email of whoever made the channel.
idtext
is_privatetrue/false
memberslist
titletext
updated_attext

Example output

{
  "created_at": "2026-06-01T09:00:00.000Z",
  "created_by": "sarah@example.com",
  "id": "01HXCHANNEL0000000000000",
  "is_private": false,
  "members": [
    {
      "email": "sarah@example.com",
      "name": "Sarah Chen",
      "user_id": "01HXUSER000000000000000"
    }
  ],
  "title": "Customer calls",
  "updated_at": "2026-07-01T09:00:00.000Z"
}

Get meeting

Get one meeting's details: who organized and attended it, when each person joined and left, who spoke, who can see it, its channel and whether its notes are ready.

Inputs

Meeting IDmeeting_idtextRequired: The meeting's ID: the 'id' of a List meetings result.

Outputs

attendancelist: When each participant joined and left, as ISO 8601.
attendeeslist: The invited attendees.
calendar_idtext: The calendar event's ID.
calendar_typetext: The calendar provider.
channel_idslist: The channel the meeting is filed in.
datetext: When the meeting took place, as ISO 8601 UTC.
durationnumber: How long the meeting lasted, in minutes.
fireflies_userslist: Participants who have a Fireflies account.
host_emailtext: Email address of the organizer (the same as organizer_email).
idtext: The meeting's unique ID. Use this with the other meeting actions.
is_livetrue/false: Whether the meeting is happening now.
meeting_linktext: The Zoom, Google Meet or Teams link, when there was one.
notetaker_joinedtrue/false: Whether the Fireflies notetaker joined.
organizer_emailtext: Email address of the organizer.
ownerobject: The Fireflies user the meeting was recorded for.
participantslist: Email addresses of everyone who took part.
privacytext: Who can see the meeting: link, owner, participants, teammatesandparticipants, teammates or participatingteammates.
silent_meetingtrue/false: Whether nothing was said.
speakerslist: The names of everyone who spoke.
summary_statustext: processing, processed, failed or skipped.
titletext: The meeting's title.
transcript_urltext: Link to the meeting in Fireflies.ai.

Example output

{
  "attendance": [
    {
      "join_time": "2026-07-15T09:00:00.000Z",
      "leave_time": "2026-07-15T09:30:00.000Z",
      "name": "Sarah Chen"
    }
  ],
  "attendees": [
    {
      "email": "sarah@example.com",
      "name": "Sarah Chen"
    },
    {
      "email": "james@example.com",
      "name": "James Lee"
    }
  ],
  "calendar_id": "7f3c2b1a@google.com",
  "calendar_type": "google",
  "channel_ids": [
    "01HXCHANNEL0000000000000"
  ],
  "date": "2026-07-15T09:00:00Z",
  "duration": 30.0,
  "fireflies_users": [
    "sarah@example.com"
  ],
  "host_email": "sarah@example.com",
  "id": "01HXAMPLE0000000000000000",
  "is_live": false,
  "meeting_link": "https://meet.google.com/abc-defg-hij",
  "notetaker_joined": true,
  "organizer_email": "sarah@example.com",
  "owner": {
    "email": "sarah@example.com",
    "id": "01HXUSER000000000000000",
    "name": "Sarah Chen"
  },
  "participants": [
    "sarah@example.com",
    "james@example.com"
  ],
  "privacy": "teammates",
  "silent_meeting": false,
  "speakers": [
    "Sarah Chen",
    "James Lee"
  ],
  "summary_status": "processed",
  "title": "Weekly Standup",
  "transcript_url": "https://app.fireflies.ai/view/01HXAMPLE0000000000000000"
}

Get meeting analytics

Get a meeting's conversation analytics: how positive or negative it was, how many questions, dates, metrics and tasks came up, and each speaker's talk time, word count, pace and filler words. Needs a Fireflies Pro plan or higher.

Inputs

Meeting IDmeeting_idtextRequired: The meeting's ID: the 'id' of a List meetings result.

Outputs

categoriesobject: How many questions, dates, metrics and tasks came up.
idtext
sentimentsobject: How positive, neutral and negative the conversation was, in percent.
speakerslist: Talk-time figures per speaker.
titletext

Example output

{
  "categories": {
    "date_times": 3.0,
    "metrics": 2.0,
    "questions": 6.0,
    "tasks": 4.0
  },
  "id": "01HXAMPLE0000000000000000",
  "sentiments": {
    "negative_pct": 4.0,
    "neutral_pct": 61.0,
    "positive_pct": 35.0
  },
  "speakers": [
    {
      "duration": 820.0,
      "duration_pct": 55.0,
      "filler_words": 12.0,
      "longest_monologue": 95.0,
      "monologues_count": 14.0,
      "name": "Sarah Chen",
      "questions": 4.0,
      "speaker_id": "0",
      "word_count": 2100.0,
      "words_per_minute": 154.0
    }
  ],
  "title": "Weekly Standup"
}

Get meeting summary

Get the AI-generated notes for one meeting, including a written overview, the action items, the key topics, an outline, a one-line gist and the meeting type. Use the List meetings action first to find the meeting's ID.

Inputs

Meeting IDmeeting_idtextRequired: The ID of the meeting to summarize. You can get this from the List meetings action.

Outputs

action_itemstext: The follow-up tasks identified in the meeting, one per line.
bullet_gisttext: A few bullet points with emoji.
datetext: When the meeting took place, as ISO 8601 UTC.
gisttext: The meeting in one sentence.
idtext
keywordslist: The main topics and terms.
meeting_typetext: What kind of meeting it was.
outlinetext: A section-by-section outline with timestamps.
short_overviewtext: A brief overview.
short_summarytext: The meeting in one paragraph.
shorthand_bullettext: Shorthand bullet notes.
summarytext: A written overview of what the meeting covered.
summary_statustext: processing, processed, failed or skipped. The notes are empty until it is processed.
titletext
topics_discussedlist: The topics discussed.
transcript_chapterslist: Chapters of the condensed transcript.

Example output

{
  "action_items": "Sarah: Follow up with the design team.\nJames: Schedule the next review.",
  "bullet_gist": "\ud83c\udfaf Q1 goals reviewed\n\ud83d\udcc5 Release timeline confirmed",
  "date": "2026-07-15T09:00:00Z",
  "gist": "The team confirmed the release timeline.",
  "id": "01HXAMPLE0000000000000000",
  "keywords": [
    "Q1 goals",
    "release timeline",
    "design review"
  ],
  "meeting_type": "Standup",
  "outline": "Q1 goals\nProject timelines\nNext steps",
  "short_overview": "Q1 review and release planning.",
  "short_summary": "The team reviewed Q1 goals and confirmed the timeline.",
  "shorthand_bullet": "Q1 goals reviewed; timelines confirmed.",
  "summary": "The team reviewed Q1 goals and confirmed project timelines for the next release.",
  "summary_status": "processed",
  "title": "Weekly Standup",
  "topics_discussed": [
    "Q1 goals",
    "Release timeline"
  ],
  "transcript_chapters": [
    "Q1 goals",
    "Release timeline"
  ]
}

Get meeting transcript

Get the full word-for-word transcript of one meeting, as a single speaker-labelled text block and as individual timestamped lines. Use the List meetings action first to find the meeting's ID.

Inputs

Meeting IDmeeting_idtextRequired: The ID of the meeting to transcribe. You can get this from the List meetings action.

Outputs

attendeeslist: The invited attendees.
datetext: When the meeting took place, as ISO 8601 UTC.
durationnumber: How long the meeting lasted, in minutes.
host_emailtext: Email address of the organizer (the same as organizer_email).
idtext: The meeting's unique ID. Use this with the other meeting actions.
meeting_linktext: The Zoom, Google Meet or Teams link, when there was one.
organizer_emailtext: Email address of the organizer.
participantslist: Email addresses of everyone who took part.
sentence_countnumber: How many transcript lines there are.
sentenceslist: The transcript line by line.
speakerslist: The names of everyone who spoke.
texttext: The whole transcript, one 'Speaker: what they said' line per sentence.
titletext: The meeting's title.
transcript_urltext: Link to the meeting in Fireflies.ai.

Example output

{
  "attendees": [
    {
      "email": "sarah@example.com",
      "name": "Sarah Chen"
    },
    {
      "email": "james@example.com",
      "name": "James Lee"
    }
  ],
  "date": "2026-07-15T09:00:00Z",
  "duration": 30.0,
  "host_email": "sarah@example.com",
  "id": "01HXAMPLE0000000000000000",
  "meeting_link": "https://meet.google.com/abc-defg-hij",
  "organizer_email": "sarah@example.com",
  "participants": [
    "sarah@example.com",
    "james@example.com"
  ],
  "sentence_count": 2,
  "sentences": [
    {
      "end_time": 3.2,
      "speaker_name": "Sarah Chen",
      "start_time": 0.5,
      "text": "Let's start with the release timeline."
    },
    {
      "end_time": 6.1,
      "speaker_name": "James Lee",
      "start_time": 3.4,
      "text": "Design review lands on Thursday."
    }
  ],
  "speakers": [
    "Sarah Chen",
    "James Lee"
  ],
  "text": "Sarah Chen: Let's start with the release timeline.\nJames Lee: Design review lands on Thursday.",
  "title": "Weekly Standup",
  "transcript_url": "https://app.fireflies.ai/view/01HXAMPLE0000000000000000"
}

Get recording links

Get download links for a meeting's audio and, if video recording is on in Fireflies, its video. The links stop working after 24 hours, so use them in the same run. Needs a Fireflies Pro plan or higher.

Inputs

Meeting IDmeeting_idtextRequired: The meeting's ID: the 'id' of a List meetings result.

Outputs

audio_urltext: A download link for the audio. It stops working after 24 hours.
idtext
titletext
video_urltext: A download link for the video, if video recording is on. It stops working after 24 hours.

Example output

{
  "audio_url": "https://cdn.fireflies.ai/audio/standup.mp3?token=abc",
  "id": "01HXAMPLE0000000000000000",
  "title": "Weekly Standup",
  "video_url": "https://cdn.fireflies.ai/video/standup.mp4?token=abc"
}

Get soundbite

Get one soundbite: its clip and thumbnail links, captions, summary and processing status.

Inputs

Soundbite IDsoundbite_idtextRequired: The 'id' of a List soundbites or Create soundbite result.

Outputs

captionslist
created_attext
created_byobject
end_timenumber: Seconds from the start of the meeting.
idtext
media_typetext: video or audio.
meeting_idtext
nametext
previewtext
privacieslist: Who can see it.
sourceslist: Where to play the clip.
start_timenumber: Seconds from the start of the meeting.
statustext: pending, processing, ready or error.
summarytext
thumbnailtext

Example output

{
  "captions": [
    {
      "end_time": 3.2,
      "speaker_name": "Sarah Chen",
      "start_time": 0.5,
      "text": "Let's start with the release timeline."
    }
  ],
  "created_at": "2026-07-15T10:00:00.000Z",
  "created_by": {
    "id": "01HXUSER000000000000000",
    "name": "Sarah Chen"
  },
  "end_time": 6.1,
  "id": "01HXBITE00000000000000000",
  "media_type": "video",
  "meeting_id": "01HXAMPLE0000000000000000",
  "name": "Release timeline",
  "preview": "https://cdn.fireflies.ai/bites/preview.mp4",
  "privacies": [
    "team"
  ],
  "sources": [
    {
      "type": "video/mp4",
      "url": "https://cdn.fireflies.ai/bites/clip.mp4"
    }
  ],
  "start_time": 0.5,
  "status": "ready",
  "summary": "Sarah sets the release timeline.",
  "thumbnail": "https://cdn.fireflies.ai/bites/thumb.jpg"
}

Get team analytics

Get the team's meeting and conversation figures for a period: meeting counts and time, talk-to-listen ratio, questions, filler words, sentiment, and the same per team member. Needs a team admin's API key and a Fireflies Business plan or higher.

Inputs

From datestart_datedate and time: The start of the period.
To dateend_datedate and time: The end of the period.

Outputs

teamobject
userslist: Figures per team member.

Example output

{
  "team": {
    "conversation": {
      "average_filler_words": 9.0,
      "average_monologues_count": 11.0,
      "average_questions": 5.0,
      "average_sentiments": {
        "negative_pct": 5.0,
        "neutral_pct": 60.0,
        "positive_pct": 35.0
      },
      "average_silence_duration": 40.0,
      "average_talk_listen_ratio": 0.8,
      "average_words_per_minute": 148.0,
      "longest_monologue_duration_sec": 210.0,
      "teammates_count": 4.0,
      "total_filler_words": 270.0,
      "total_meeting_notes_count": 30.0,
      "total_meetings_count": 30.0,
      "total_monologues_count": 330.0,
      "total_questions": 150.0,
      "total_silence_duration": 1200.0
    },
    "meeting": {
      "average_count": 7.5,
      "average_duration": 30.0,
      "count": 30.0,
      "duration": 900.0
    }
  },
  "users": [
    {
      "conversation": {
        "talk_listen_pct": 55.0,
        "talk_listen_ratio": 1.2,
        "total_silence_duration": 300.0,
        "total_speak_duration": 8200.0,
        "total_word_count": 21000.0,
        "user_filler_words": 80.0,
        "user_longest_monologue_sec": 210.0,
        "user_monologues_count": 90.0,
        "user_questions": 40.0,
        "user_speak_duration": 8200.0,
        "user_word_count": 21000.0,
        "user_words_per_minute": 154.0
      },
      "email": "sarah@example.com",
      "meeting": {
        "count": 12.0,
        "duration": 360.0
      },
      "name": "Sarah Chen",
      "user_id": "01HXUSER000000000000000"
    }
  ]
}

Get team member

Get one team member's details and user groups. Leave the team member blank to get the API key's owner, which also shows whose account the connection uses.

Inputs

Team membermember_idtext: Leave blank for the API key's owner.

Outputs

emailtext
idtext: The member's Fireflies user ID.
integrationslist: Their connected integrations.
is_admintrue/false: Whether they administer the team.
minutes_consumednumber: Transcription minutes used.
nametext
num_transcriptsnumber: How many meetings they have recorded.
recent_meetingtext: Their most recent meeting.
recent_transcripttext: Their most recent transcript.
user_groupslist: The user groups they belong to.

Example output

{
  "email": "sarah@example.com",
  "id": "01HXUSER000000000000000",
  "integrations": [
    "google_calendar",
    "slack"
  ],
  "is_admin": true,
  "minutes_consumed": 3400.0,
  "name": "Sarah Chen",
  "num_transcripts": 128.0,
  "recent_meeting": "01HXAMPLE0000000000000000",
  "recent_transcript": "01HXAMPLE0000000000000000",
  "user_groups": [
    {
      "handle": "sales",
      "id": "grp_sales",
      "name": "Sales"
    }
  ]
}

List active meetings

List the meetings the Fireflies notetaker is in right now, with their IDs for the live meeting actions. Without an email this lists the API key owner's; a team admin can ask for any teammate's.

Inputs

Team member's emailemailtext: Whose meetings to list. Leave blank for the API key's owner.
Statestateslist: Leave blank for both recording and paused meetings.One or more of: active (Recording), paused.

Outputs

meetingslist: The meetings in progress.

Example output

{
  "meetings": [
    {
      "end_time": "2026-07-15T15:00:00.000Z",
      "id": "01HXLIVE00000000000000000",
      "meeting_link": "https://zoom.us/j/123456789",
      "organizer_email": "sarah@example.com",
      "privacy": "teammates",
      "start_time": "2026-07-15T14:00:00.000Z",
      "state": "active",
      "title": "Customer call: Acme Corp"
    }
  ]
}

List AI app outputs

List what your Fireflies AI apps (custom prompts run on each meeting, such as 'Sales call scorecard') wrote, for one meeting, one app, or both. Returns up to 10 at a time.

Inputs

Meeting IDmeeting_idtext: Only outputs for this meeting: the 'id' of a List meetings result.
AI app IDapp_idtext: Only outputs of this AI app: an 'app_id' from an earlier result.
Maximum outputslimitnumber: How many to return, from 1 to 10.From 1 to 10.
Skipskipnumber: How many results to skip, to read the next page.At least 0.

Outputs

outputslist: The AI app outputs.

Example output

{
  "outputs": [
    {
      "app_id": "app_scorecard",
      "created_at": "2026-07-15T09:33:20Z",
      "meeting_id": "01HXAMPLE0000000000000000",
      "prompt": "Score the call on discovery, demo and next steps.",
      "response": "Discovery: 4/5. Demo: 3/5. Next steps: agreed.",
      "title": "Sales call scorecard",
      "user_id": "01HXUSER000000000000000"
    }
  ]
}

List Ask Fred conversations

List the API key owner's Ask Fred conversations. Fireflies keeps conversations about one meeting out of the full list, so to find those, choose the meeting.

Inputs

Meeting IDmeeting_idtext: List the conversations about this meeting. Leave blank for the ones asked across meetings.

Outputs

threadslist: The conversations.

Example output

{
  "threads": [
    {
      "created_at": "2026-07-15T10:30:00Z",
      "id": "thread_abc123",
      "meeting_id": "01HXAMPLE0000000000000000",
      "title": "What did we decide about the release?",
      "user_id": "01HXUSER000000000000000"
    }
  ]
}

List channels

List the channels (folders that meetings are filed in) the API key's owner can see: every public channel and the private ones they belong to.

Inputs

None.

Outputs

channelslist: The channels the key's owner can see.

Example output

{
  "channels": [
    {
      "created_at": "2026-06-01T09:00:00.000Z",
      "created_by": "sarah@example.com",
      "id": "01HXCHANNEL0000000000000",
      "is_private": false,
      "members": [
        {
          "email": "sarah@example.com",
          "name": "Sarah Chen",
          "user_id": "01HXUSER000000000000000"
        }
      ],
      "title": "Customer calls",
      "updated_at": "2026-07-01T09:00:00.000Z"
    }
  ]
}

List contacts

List the people the API key's owner has met with, with the date of their last meeting together.

Inputs

None.

Outputs

contactslist: People you have met with.

Example output

{
  "contacts": [
    {
      "email": "client@example.com",
      "last_meeting_date": "2026-07-15",
      "name": "Alex Morgan",
      "picture": ""
    }
  ]
}

List live action items

List the action items so far in a meeting that is happening now, both those Fireflies noticed and those added with Add live action item. Only the meeting's organizer or a team admin can read them.

Inputs

Meeting IDmeeting_idtextRequired: The live meeting's ID: the 'id' of a List active meetings result.

Outputs

action_itemslist: The action items so far.

Example output

{
  "action_items": [
    {
      "action_item": "Send the revised quote to Acme by Friday.",
      "name": "James Lee"
    }
  ]
}

List meetings

List the meetings Fireflies.ai has recorded and transcribed, newest first. Search titles or what was said, and narrow the results to a date range, an organizer, a participant, a team member or a channel. Use this to find a meeting's ID before reading its notes or transcript.

Inputs

Search forkeywordtext: Only meetings that mention this. Searches titles unless Search in says otherwise.
Search insearch_intext: Where to look for the search words. Defaults to titles.One of: title (Meeting titles), sentences (What was said), all (Titles and what was said).
From datestart_datedate and time: Only include meetings held on or after this date and time, for example 2026-07-15T09:00:00Z. Leave blank to include meetings from any start date.
To dateend_datedate and time: Only include meetings held on or before this date and time, for example 2026-07-31T17:00:00Z. Leave blank to include meetings up to the present.
Maximum meetingslimitnumber: The most meetings to return, from 1 to 50. Leave blank to use the Fireflies default.From 1 to 50.
Skipskipnumber: How many results to skip, to read the next page.At least 0.
Host emailhost_emailtext: Only include meetings hosted by this email address. Leave blank to include meetings from any host.
Organizer emailorganizer_emailtext: Only meetings organized by one of these addresses. Separate several with commas.
Participant emailparticipant_emailtext: Only include meetings one of these email addresses attended. Separate several with commas. Leave blank to include meetings with any participant.
Team membermember_idtext: Only meetings this team member organized or attended.
Only my meetingsminetrue/false: Only meetings the API key's owner organized.
Channelchannel_idtext: Only meetings filed in this channel.

Outputs

meetingslist: The matching meetings, newest first.

Example output

{
  "meetings": [
    {
      "attendees": [
        {
          "email": "sarah@example.com",
          "name": "Sarah Chen"
        },
        {
          "email": "james@example.com",
          "name": "James Lee"
        }
      ],
      "date": "2026-07-15T09:00:00Z",
      "duration": 30.0,
      "host_email": "sarah@example.com",
      "id": "01HXAMPLE0000000000000000",
      "meeting_link": "https://meet.google.com/abc-defg-hij",
      "organizer_email": "sarah@example.com",
      "participants": [
        "sarah@example.com",
        "james@example.com"
      ],
      "title": "Weekly Standup",
      "transcript_url": "https://app.fireflies.ai/view/01HXAMPLE0000000000000000"
    }
  ]
}

List soundbites

List soundbites (short clips cut from meetings): yours, your team's, or one meeting's. With nothing chosen it lists yours.

Inputs

Meeting IDmeeting_idtext: Only clips from this meeting: the 'id' of a List meetings result.
Whose soundbitesownertext: Yours or your whole team's.One of: mine, team (My team's).
Maximum soundbiteslimitnumber: How many to return, from 1 to 50.From 1 to 50.
Skipskipnumber: How many to skip, up to 5,000, to read the next page.From 0 to 5000.

Outputs

soundbiteslist: The soundbites.

Example output

{
  "soundbites": [
    {
      "captions": [
        {
          "end_time": 3.2,
          "speaker_name": "Sarah Chen",
          "start_time": 0.5,
          "text": "Let's start with the release timeline."
        }
      ],
      "created_at": "2026-07-15T10:00:00.000Z",
      "created_by": {
        "id": "01HXUSER000000000000000",
        "name": "Sarah Chen"
      },
      "end_time": 6.1,
      "id": "01HXBITE00000000000000000",
      "media_type": "video",
      "meeting_id": "01HXAMPLE0000000000000000",
      "name": "Release timeline",
      "preview": "https://cdn.fireflies.ai/bites/preview.mp4",
      "privacies": [
        "team"
      ],
      "sources": [
        {
          "type": "video/mp4",
          "url": "https://cdn.fireflies.ai/bites/clip.mp4"
        }
      ],
      "start_time": 0.5,
      "status": "ready",
      "summary": "Sarah sets the release timeline.",
      "thumbnail": "https://cdn.fireflies.ai/bites/thumb.jpg"
    }
  ]
}

List team members

List the people in your Fireflies.ai workspace, with how many meetings each has recorded. Use this to find the email address or user ID to filter meetings by.

Inputs

None.

Outputs

userslist: The people on the team.

Example output

{
  "users": [
    {
      "email": "sarah@example.com",
      "id": "01HXUSER000000000000000",
      "integrations": [
        "google_calendar",
        "slack"
      ],
      "is_admin": true,
      "minutes_consumed": 3400.0,
      "name": "Sarah Chen",
      "num_transcripts": 128.0,
      "recent_meeting": "01HXAMPLE0000000000000000"
    }
  ]
}

List user groups

List the team's user groups and their members.

Inputs

Only groups I'm inminetrue/false: Only the groups the API key's owner belongs to.

Outputs

user_groupslist: The user groups.

Example output

{
  "user_groups": [
    {
      "handle": "sales",
      "id": "grp_sales",
      "members": [
        {
          "email": "sarah@example.com",
          "first_name": "Sarah",
          "last_name": "Chen",
          "name": "Sarah Chen",
          "user_id": "01HXUSER000000000000000"
        }
      ],
      "name": "Sales"
    }
  ]
}

Move meetings to a channel

File up to 5 meetings in a channel (a Fireflies folder). A meeting is in one channel at a time, so this replaces its current one. If any meeting can't be moved, none are. Only the meetings' owner or a team admin can do this.

Inputs

Meeting IDsmeeting_idslistRequired: One to five meeting IDs.
Channelchannel_idtextRequired: The channel (folder). Pick one, or give a channel's ID.

Outputs

channel_idtext
meetingslist: The meetings that were moved.

Example output

{
  "channel_id": "01HXCHANNEL0000000000000",
  "meetings": [
    {
      "channel_ids": [
        "01HXCHANNEL0000000000000"
      ],
      "id": "01HXAMPLE0000000000000000",
      "title": "Weekly Standup"
    }
  ]
}

Pause or resume recording

Pause or resume the Fireflies notetaker's recording in a meeting that is happening now. Only the meeting's organizer or a team admin can, up to 10 times an hour.

Inputs

Meeting IDmeeting_idtextRequired: The live meeting's ID: the 'id' of a List active meetings result.
RecordingrecordingtextRequired: Pause or resume.One of: pause_recording (Pause recording), resume_recording (Resume recording).

Outputs

actiontext: pause_recording or resume_recording.
successtrue/false

Example output

{
  "action": "pause_recording",
  "success": true
}

Remove member from user group

Remove a teammate from a user group by email. Needs a team admin's API key and a Fireflies Business plan or higher.

Inputs

User groupgroup_idtextRequired: The user group. Pick one, or give its ID.
Team member's emailemailtextRequired: The email address of someone on your Fireflies team.

Outputs

handletext
idtext
memberslist
nametext

Example output

{
  "handle": "sales",
  "id": "grp_sales",
  "members": [],
  "name": "Sales"
}

Rename meeting

Change a meeting's title. Fireflies only lets team admins rename meetings, and the title must be 5 to 256 characters.

Inputs

Meeting IDmeeting_idtextRequired: The meeting's ID: the 'id' of a List meetings result.
New titletitletextRequired: The new title, 5 to 256 characters.

Outputs

idtext
titletext

Example output

{
  "id": "01HXAMPLE0000000000000000",
  "title": "Weekly Standup: Q3 planning"
}

Send notetaker to a meeting

Send the Fireflies.ai notetaker into a meeting that is happening now, so it records and transcribes the call. Works with Zoom, Google Meet, and Microsoft Teams links. Fireflies allows 3 of these requests every 20 minutes.

Inputs

Meeting linkmeeting_linktextRequired: The https link to the live meeting to join, for example a Zoom, Google Meet, or Microsoft Teams URL.
Meeting titletitletext: The title to file the recording under in Fireflies. Leave blank to use the meeting's own name.
Meeting passwordmeeting_passwordtext: The password or passcode the meeting needs, if it has one (up to 32 characters).
Minutes to staydurationnumber: How many minutes the notetaker should stay, from 15 to 120. Leave blank for 60.From 15 to 120.
Meeting languagelanguagetext: The language spoken in the meeting, as a code such as 'en' or 'es'. Leave blank for English.
Attendeesattendeeslist: Who is taking part. Each attendee needs an email; name and phone_number are optional. Fireflies uses them to file notes in a connected CRM.

Outputs

successtrue/false: Whether Fireflies did it.

Example output

{
  "success": true
}

Set team member's role

Make a team member an admin or a regular member. Needs a team admin's API key, and the team must keep at least one admin.

Inputs

Team membermember_idtextRequired: The team member. Pick one, or give their Fireflies user ID.
RoleroletextRequired: Admin or member.One of: admin, user (Member).

Outputs

idtext
is_admintrue/false: Whether they are now a team admin.
nametext
roletext: admin or user.

Example output

{
  "id": "01HXUSER000000000000000",
  "is_admin": true,
  "name": "Sarah Chen",
  "role": "admin"
}

Share a meeting with up to 50 people by email, even outside your team, for good or for 7, 14 or 30 days. Fireflies emails them a link. Only the meeting's owner or a team admin can share, up to 60 times an hour.

Inputs

Meeting IDmeeting_idtextRequired: The meeting's ID: the 'id' of a List meetings result.
Share withemailslistRequired: The email addresses to share with, up to 50.
Access expires afterexpiry_daystext: Leave blank for access that never expires.One of: 7 (7 days), 14 (14 days), 30 (30 days).
Share asshare_typetext: An email invitation, or a password-protected link that works without a Fireflies account. Password links are in beta at Fireflies: ask their support to turn them on.One of: EMAIL (Invite by email), PASSWORD_LINK (Password-protected link (beta)).
Link passwordpasswordtext: 8 to 128 characters. Fireflies does not email it, so send it to them separately.Only when Share as is Password-protected link (beta).

Outputs

messagetext: What Fireflies said, such as already invited.
share_linktext: The password-protected link, when one was made.
shared_withlist: The addresses it was shared with.
successtrue/false: Whether Fireflies shared the meeting.

Example output

{
  "message": "Invite created successfully",
  "share_link": "",
  "shared_with": [
    "client@example.com"
  ],
  "success": true
}

Take back one person's access to a meeting that was shared with them. Only the meeting's owner or a team admin can do this.

Inputs

Meeting IDmeeting_idtextRequired: The meeting's ID: the 'id' of a List meetings result.
EmailemailtextRequired: The address the meeting was shared with.

Outputs

emailtext
messagetext
successtrue/false

Example output

{
  "email": "client@example.com",
  "message": "Access revoked",
  "success": true
}

Transcribe a recording

Send an audio or video recording to Fireflies.ai to be transcribed. The file is fetched from a URL and transcribed in the background, so its notes appear in the List meetings action a few minutes later. Needs a paid Fireflies plan: on the free plan this action returns 'You need to be subscribed to a paid plan to perform this action', though the rest of the integration still works. Fireflies rejects files smaller than 50KB unless told otherwise.

Inputs

Recording URLurltextRequired: An https link to the audio or video file to transcribe (mp3, mp4, wav, m4a or ogg). It must be the file itself, not a preview page, and public or pre-signed unless Download sign-in is set.
Meeting titletitletext: The title to file the recording under in Fireflies. Leave blank to use the file name.
Attendeesattendeeslist: Who is taking part. Each attendee needs an email; name and phone_number are optional. Fireflies uses them to file notes in a connected CRM.
Meeting datemeeting_datedate and time: When the meeting really took place, for importing old recordings. It can't be in the future. Leave blank to date it now.
Languagelanguagetext: The language spoken, as a code such as 'es' or 'de'. Leave blank for your Fireflies default.
Reference IDclient_reference_idtext: Your own ID for this upload, up to 128 characters. Fireflies sends it back in its webhook.
Webhook URLwebhook_urltext: A URL Fireflies calls when the transcript is ready.
Save videosave_videotrue/false: Keep the video, not just the audio, of a video file.
Allow recordings under 50KBbypass_size_checktrue/false: Transcribe very short clips that Fireflies would otherwise reject as too small.
Download sign-indownload_authtext: How Fireflies signs in to download a file that isn't public.One of: none (None (a public or pre-signed link)), bearer_token (Bearer token), basic_auth (Username and password).
Download tokendownload_tokentext: Sent as 'Authorization: Bearer <token>'.Only when Download sign-in is Bearer token.
Download usernamedownload_usernametext: Optional.Only when Download sign-in is Username and password.
Download passworddownload_passwordtext: The password for the file's server.Only when Download sign-in is Username and password.

Outputs

messagetext: What Fireflies reported about the upload.
successtrue/false: Whether Fireflies accepted the recording.
titletext: The title the recording was filed under.

Example output

{
  "message": "Uploaded audio has been queued for processing.",
  "success": true,
  "title": "Customer call: Acme Corp"
}

ActionsCopy Anchor Link

Add live action itemCopy Anchor Link

Inputs

Outputs

Add member to user groupCopy Anchor Link

Inputs

Outputs

Ask FredCopy Anchor Link

Inputs

Outputs

Ask Fred a follow-upCopy Anchor Link

Inputs

Outputs

Change who can see a meetingCopy Anchor Link

Inputs

Outputs

Clip live soundbiteCopy Anchor Link

Inputs

Outputs

Create soundbiteCopy Anchor Link

Inputs

Outputs

Delete Ask Fred conversationCopy Anchor Link

Inputs

Outputs

Delete meetingCopy Anchor Link

Inputs

Outputs

Get Ask Fred conversationCopy Anchor Link

Inputs

Outputs

Get channelCopy Anchor Link

Inputs

Outputs

Get meetingCopy Anchor Link

Inputs

Outputs

Get meeting analyticsCopy Anchor Link

Inputs

Outputs

Get meeting summaryCopy Anchor Link

Inputs

Outputs

Get meeting transcriptCopy Anchor Link

Inputs

Outputs

Get recording linksCopy Anchor Link

Inputs

Outputs

Get soundbiteCopy Anchor Link

Inputs

Outputs

Get team analyticsCopy Anchor Link

Inputs

Outputs

Get team memberCopy Anchor Link

Inputs

Outputs

List active meetingsCopy Anchor Link

Inputs

Outputs

List AI app outputsCopy Anchor Link

Inputs

Outputs

List Ask Fred conversationsCopy Anchor Link

Inputs

Outputs

List channelsCopy Anchor Link

Inputs

Outputs

List contactsCopy Anchor Link

Inputs

Outputs

List live action itemsCopy Anchor Link

Inputs

Outputs

List meetingsCopy Anchor Link

Inputs

Outputs

Actions

Add live action item

Add member to user group

Ask Fred

Ask Fred a follow-up

Change who can see a meeting

Clip live soundbite

Create soundbite

Delete Ask Fred conversation

Delete meeting

Get Ask Fred conversation

Get channel

Get meeting

Get meeting analytics

Get meeting summary

Get meeting transcript

Get recording links

Get soundbite

Get team analytics

Get team member

List active meetings

List AI app outputs

List Ask Fred conversations

List channels

List contacts

List live action items

List meetings

List soundbites

List team members

List user groups

Move meetings to a channel

Pause or resume recording

Remove member from user group

Rename meeting

Send notetaker to a meeting

Set team member's role

Share meeting

Stop sharing meeting

Transcribe a recording