Skip to main content
Fireflies logo
  • Category: ai meeting assistants
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 26
  • Triggers: 1
  • Slug: FIREFLIES
  • Version: 20261101_00

Tools

Slug: FIREFLIES_ADD_TO_LIVEThe AddToLive Action allows you to add the Fireflies.ai bot to an ongoing meeting. Note: This action requires a paid Fireflies plan to add bots to meetings.

Input Parameters

string
Title or name of the meeting, this will be used to identify the transcribed file. If title is not provided, a default title will be set automatically
integer
Meeting duration in minutes. Minimum of 15 and maximum of 120 minutes. Defaults to 60 minutes if param is not provided
string
Language code for the meeting (max 5 characters). Defaults to ‘en’ (English). Common codes: en, en-US, en-GB, fr, de, es, zh, ja, pt, ar. For a complete list of language codes, please view Fireflies Language Codes documentation.
array
Array of Attendees for expected meeting participants.
A valid http URL for the meeting link, i.e. Google Meet, Zoom, etc
string
Password for the meeting, if applicable.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FIREFLIES_CONTINUE_ASK_FRED_THREADTool to continue an existing AskFred conversation thread with follow-up questions. This action CANNOT create new threads - it only works with existing thread IDs. Use when you need to maintain context from previous exchanges and ask additional questions about meeting data in the same conversation. To start a new thread, use FIREFLIES_CREATE_ASK_FRED_THREAD instead.

Input Parameters

string
required
Follow-up question or query to ask in the context of the existing thread. Maximum 2000 characters.
string
required
The ID of an existing AskFred thread obtained from a previous AskFred interaction (via FIREFLIES_CREATE_ASK_FRED_THREAD or FIREFLIES_GET_ASK_FRED_THREADS). Must be a real thread ID - placeholder values like ‘new’ or ‘latest’ are not valid. To start a new conversation, use FIREFLIES_CREATE_ASK_FRED_THREAD instead.
string
Response format mode. Use ‘markdown’ for rich formatting with structure, or ‘plaintext’ for simple text output.
string
Language code for the response (e.g., ‘en’ for English, ‘es’ for Spanish). If not specified, defaults to English.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FIREFLIES_CREATE_ASK_FRED_THREADStarts a new AskFred conversation with a natural-language question about one meeting or multiple meetings using filters. For multi-meeting filters, start times older than approximately 364 days are moved forward to that boundary.

Input Parameters

string
required
Your question or query about the meeting(s). Maximum 2000 characters. Examples: ‘What were the action items?’, ‘Who attended the meeting?’, ‘What were the main topics discussed?’
object
Filters to search across multiple meetings.
string ("markdown" | "plaintext")
Response format - ‘markdown’ for rich formatting or ‘plaintext’ for plain text.
string
ID of a specific transcript/meeting to query. If provided, filters parameter is ignored. Use this for single-meeting queries. Transcript IDs are alphanumeric strings (e.g., ‘01JYH3WSWW2DVA72GFPQXC6ST0’). Use FIREFLIES_GET_TRANSCRIPTS to retrieve valid transcript IDs from your account.
string
Language code for response (e.g., ‘en’ for English, ‘es’ for Spanish, ‘fr’ for French).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FIREFLIES_CREATE_BITETool to create a bite (short video or audio clip) from a transcript segment. Use when you need to extract a specific portion of a meeting recording with defined start and end times.

Input Parameters

string
Name for the bite. Maximum 256 characters.
string
Summary for the bite. Maximum 500 characters.
number
required
End time of the bite in seconds. Must be greater than start_time.
array
Visibility settings for the bite. Array can contain ‘public’, ‘team’, or ‘participants’.
string ("video" | "audio")
Type of bite to create. Must be either ‘video’ or ‘audio’. If not specified, defaults to ‘video’.
number
required
Start time of the bite in seconds. Must be non-negative and less than end_time.
string
required
The ID of the transcript from which to create the bite.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FIREFLIES_DELETE_TRANSCRIPT_BY_IDPermanently delete a transcript from the Fireflies account by its unique ID. This is a destructive action that cannot be undone. The transcript, along with its associated audio/video files and summaries, will be permanently removed. Rate limited to 10 requests per minute across all user tiers. Verify the target transcript via FIREFLIES_GET_TRANSCRIPTS and obtain explicit user confirmation before calling this tool.

Input Parameters

string
required
The unique ID of the transcript to delete. This is a required field.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FIREFLIES_FETCH_AI_APP_OUTPUTS2Tool to fetch AI App outputs for specific apps or transcripts. Use when you need to retrieve AI-generated results from Fireflies AI Apps for meetings.

Input Parameters

integer
Number of records to skip over for pagination.
integer
Maximum number of apps outputs to fetch (default: 10, max: 10).
string
Retrieves all outputs against a specific AI App. If not provided, returns outputs for all AI Apps.
string
Retrieves all outputs against a specific meeting/transcript. If not provided, returns outputs for all meetings.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FIREFLIES_GET_ASK_FRED_THREADTool to get a specific AskFred conversation thread with full history. Use when retrieving a particular AskFred thread along with all its messages and conversation details.

Input Parameters

string
required
The unique identifier of the AskFred thread to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FIREFLIES_GET_ASK_FRED_THREADSTool to retrieve a summary of all AskFred conversation threads for the current user. Use when you need to browse or list available AskFred conversations without fetching full message history.

Input Parameters

string
Filter threads to only those associated with a specific transcript ID. If not provided, returns all threads for the current user.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FIREFLIES_GET_BITE_BY_IDFetches details for a specific bite by ID. Requires a Fireflies plan that supports Bites and appropriate API scope. If the bite is not found, use FIREFLIES_GET_TRANSCRIPT_BY_ID to retrieve full transcript context instead.

Input Parameters

string
required
The ID of the bite to fetch.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FIREFLIES_GET_BITESFetches a list of bites (highlights) against input arguments. Bites are generated asynchronously after transcript completion — only call this after FIREFLIES_GET_TRANSCRIPT_BY_ID reports status=completed. Empty results are possible for valid meetings; use FIREFLIES_GET_TRANSCRIPT_BY_ID for full transcript context when bites are unavailable.

Input Parameters

boolean
Filter to include only the user’s own bites. At least one of mine, transcript_id, or my_team must be provided.
integer
Number of bites to skip.
integer
Maximum number of bites to fetch.
boolean
Filter to include bites from the user’s team. At least one of mine, transcript_id, or my_team must be provided.
string
The ID of the transcript to fetch bites for. At least one of mine, transcript_id, or my_team must be provided.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FIREFLIES_GET_MEETING_ANALYTICSRetrieves comprehensive meeting analytics including team-level conversation metrics, sentiment analysis, and individual user performance data. Requires a Fireflies Business plan or higher to access analytics data. Use this action when you need to analyze meeting patterns, track engagement metrics, or generate reports on team collaboration effectiveness. Admin privileges are required to access team-level analytics.

Input Parameters

string
Filter results up to this datetime (ISO 8601 format, e.g., ‘2024-01-31T23:59:59Z’). If omitted, analytics will include data up to the current time.
string
Filter results from this datetime onwards (ISO 8601 format, e.g., ‘2024-01-01T00:00:00Z’). If omitted, analytics will include all historical data up to end_time.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FIREFLIES_GET_MEETING_PARTICIPANTSRetrieves the list of participants who attended a specific Fireflies meeting along with their attendance details. Returns participant emails, detailed attendee information (names, emails, phone numbers), join/leave timestamps, speaker identifications, and meeting metadata. Use this action when you need to know who attended a meeting, when they joined/left, or which speakers were identified in the transcript. Only works with completed transcripts - incomplete transcripts may return partial or missing participant data.

Input Parameters

string
required
The unique identifier of the transcript/meeting to fetch participants for. This is the Fireflies transcript ID. Only works with completed transcripts.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FIREFLIES_GET_MEETING_TOPICSRetrieves AI-extracted topics, keywords, and meeting type for a specific Fireflies transcript. This action returns only topic-related metadata from the transcript summary, making it more efficient than fetching the entire transcript. Use this action when you need to understand what topics were discussed in a meeting without retrieving the full transcript content, sentences, or attendee details.

Input Parameters

string
required
The unique identifier of the transcript to fetch topics for. This is the Fireflies transcript ID returned when listing transcripts or from the transcript_url. Only call with IDs whose transcript status is ‘completed’; incomplete transcripts may return empty or missing topics.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FIREFLIES_GET_TRANSCRIPT_BY_IDFetches details for a specific Fireflies transcript ID, including sentences, attendees and summary when available. Fields can be null, summary action items may be a single string, and partial results may include a warning when fields require a paid plan.

Input Parameters

string
required
The unique identifier of the transcript to fetch. This is the Fireflies transcript ID returned when listing transcripts or from the transcript_url. Only call with IDs whose transcript status is ‘completed’; incomplete transcripts return partial or missing content.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FIREFLIES_GET_TRANSCRIPTSFetches a list of transcripts against input filters. Metadata filters (title, host_email, organizers, participants) match transcript metadata only, not spoken content. Pagination via skip/limit may trigger HTTP 429 on rapid requests; use backoff between pages.

Input Parameters

integer
Number of transcripts to skip. Use with limit for pagination; stop when returned count is less than limit.
integer
Maximum number of transcripts to fetch. Maximum allowed value is 50.
string
Title of the meeting. Matches meeting metadata title only, not spoken content.
string
End date for filtering transcripts. Must be in ISO 8601 datetime format with timezone (e.g., ‘2024-08-26T23:59:59Z’ or ‘2024-08-26T23:59:59+00:00’). Date-only formats are not accepted.
string
The User ID to fetch the transcripts of.
string
Start date for filtering transcripts. Must be in ISO 8601 datetime format with timezone (e.g., ‘2024-08-16T00:00:00Z’ or ‘2024-08-16T00:00:00+00:00’). Date-only formats are not accepted. Must be earlier than to_date. Filters are evaluated in UTC — convert local date ranges to UTC to avoid silently omitting meetings.
string
Email address of the host of the meeting. Must be a plain email address without markup or ‘mailto:’ prefix. Example: ‘user@example.com’.
array
List of organizer email addresses to filter transcripts by.
array
List of participant email addresses to filter transcripts by.
boolean
Whether to include AI-generated summary (action items, keywords, overview, notes, etc.) in response. Can significantly increase response size. summary.action_items may be a single formatted string rather than a list — split by newline rather than iterating as an array.
string
DEPRECATED: Use ‘organizers’ instead. Email of the organizer of the meeting.
boolean
Whether to include analytics data (sentiments, categories, speaker stats) in response. Requires Pro+ plan. If your plan doesn’t support this, the request may fail with a generic error.
boolean
Whether to include audio_url field in response. Requires Pro+ plan. If your plan doesn’t support this, the request may fail with a generic error.
boolean
Whether to include sentences array (transcript text with speaker/timing info) in response. Can produce very large responses - a single transcript may contain hundreds of sentences. Each sentence object contains speaker_name, text, start_time, end_time fields. Some transcripts may return null or empty sentences array.
boolean
Whether to include video_url field in response. Requires Business+ plan. If your plan doesn’t support this, the request may fail with a generic error.
string
DEPRECATED: Use ‘participants’ instead. Email of a participant in the meeting.
boolean
Whether to include apps_preview (AI app outputs) in response.
boolean
Whether to include detailed user information with nested user_groups and members. When False, only basic user fields (user_id, email, name) are returned.
boolean
Whether to include detailed meeting_attendees array (display names, emails, phone numbers) in response.
boolean
Whether to include meeting_attendance array (join/leave timestamps for participants) in response.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FIREFLIES_GET_USER_BY_IDThe GetUser Action is designed to fetch details associated with a specific user id.

Input Parameters

string
required
The User ID to the details of.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FIREFLIES_GET_USER_GROUPSTool to fetch a list of all user groups within the team with information about user groups including their members. Use when you need to retrieve team user groups, optionally filtering to only groups the current user belongs to with the mine parameter.

Input Parameters

boolean
Filters results to return only user groups the current user belongs to when set to true. Returns all team user groups when false or omitted.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FIREFLIES_GET_USERSFetches a list of all users within the team, including their full email addresses. Use to resolve complete email addresses from user names before passing to tools that require exact email addresses (no partial addresses or domain-only values).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FIREFLIES_GRAPHQL_QUERYExecutes an authenticated, read-only Fireflies GraphQL query and returns validated data, errors, and extensions when available. Useful for accessing query results and error details when higher-level tools encounter schema mismatches.

Input Parameters

string
required
GraphQL query document (read-only operations only). Must contain only ‘query’ operations. Mutations and subscriptions are not allowed.
object
GraphQL variables as a JSON object. Used to pass dynamic values to parameterized queries.
string
Operation name to execute when multiple operations are present in the query document.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FIREFLIES_LIST_CHANNELSFetches a list of all channels accessible to the authenticated user, including both public channels and private channels where the user is a member. Use this action when you need to discover available channels, retrieve channel IDs for organizing meetings, or check channel membership before assigning meetings to a specific channel.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FIREFLIES_SEARCH_TRANSCRIPTSSearch transcripts using keyword-based full-text search across meeting titles and/or spoken content. Unlike GetTranscripts which only filters by metadata (title, participants, dates), this action performs semantic search within the actual transcript text using the ‘keyword’ parameter. Use this action when you need to find meetings where specific topics, phrases, or keywords were discussed during the conversation. Combine with ‘scope’ to control search boundaries (title-only, content-only, or both) and with standard filters (dates, participants) to narrow results.

Input Parameters

boolean
Show only meetings owned by the API key owner. When true, returns only transcripts associated with the authenticated user.
integer
Number of transcripts to skip. Use with limit for pagination; stop when returned count is less than limit.
integer
Maximum number of transcripts to fetch. Maximum allowed value is 50.
string ("title" | "sentences" | "all")
Determines the scope of the keyword search.
string
required
Search for keywords in meeting title and/or words spoken during the meeting. Maximum 255 characters. Use with ‘scope’ to control where to search.
string
End date for filtering transcripts. Must be in ISO 8601 datetime format with timezone (e.g., ‘2024-08-26T23:59:59Z’ or ‘2024-08-26T23:59:59+00:00’). Date-only formats are not accepted.
string
The User ID to fetch the transcripts of.
string
Start date for filtering transcripts. Must be in ISO 8601 datetime format with timezone (e.g., ‘2024-08-16T00:00:00Z’ or ‘2024-08-16T00:00:00+00:00’). Date-only formats are not accepted. Must be earlier than to_date. Filters are evaluated in UTC — convert local date ranges to UTC to avoid silently omitting meetings.
string
Filter transcripts by specific channel ID.
string
Email address of the host of the meeting. Must be a plain email address without markup or ‘mailto:’ prefix. Example: ‘user@example.com’.
array
List of organizer email addresses to filter transcripts by.
array
List of participant email addresses to filter transcripts by.
boolean
Whether to include AI-generated summary (action items, keywords, overview, notes, etc.) in response. Can significantly increase response size. summary.action_items may be a single formatted string rather than a list — split by newline rather than iterating as an array.
boolean
Whether to include analytics data (sentiments, categories, speaker stats) in response. Requires Pro+ plan. If your plan doesn’t support this, the request may fail with a generic error.
boolean
Whether to include audio_url field in response. Requires Pro+ plan. If your plan doesn’t support this, the request may fail with a generic error.
boolean
Whether to include sentences array (transcript text with speaker/timing info) in response. Can produce very large responses - a single transcript may contain hundreds of sentences. Each sentence object contains speaker_name, text, start_time, end_time fields. Some transcripts may return null or empty sentences array.
boolean
Whether to include video_url field in response. Requires Business+ plan. If your plan doesn’t support this, the request may fail with a generic error.
boolean
Whether to include apps_preview (AI app outputs) in response.
boolean
Whether to include detailed user information with nested user_groups and members. When False, only basic user fields (user_id, email, name) are returned.
boolean
Whether to include detailed meeting_attendees array (display names, emails, phone numbers) in response.
boolean
Whether to include meeting_attendance array (join/leave timestamps for participants) in response.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FIREFLIES_SET_USER_ROLETool to update a user’s role within a team. Use when you need to grant or revoke admin privileges. Only team administrators can execute this action. Teams must maintain at least one admin member at all times.

Input Parameters

string ("admin" | "user")
required
Role assignment to set for the user. Valid options are ‘admin’ (grants administrative privileges) and ‘user’ (standard user permissions).
string
required
Unique identifier of the target user whose role will be updated.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FIREFLIES_UPDATE_MEETING_CHANNELTool to batch update channel assignments for 1-5 meeting transcripts. Use when you need to assign meetings to a specific channel. Requires meeting owner or team admin privileges. All-or-nothing semantics: if any transcript fails validation, none are updated.

Input Parameters

string
required
The channel identifier to assign to all specified transcripts. A meeting can only belong to one channel at a time.
array
required
Array of transcript IDs to assign to the channel. Must contain between 1 and 5 transcript IDs. All specified meetings must be owned by users in your team.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FIREFLIES_UPDATE_MEETING_PRIVACYTool to update the privacy setting of a meeting transcript. Use when you need to change meeting access permissions. Only meeting owners and team admins can update privacy settings.

Input Parameters

string
required
The transcript identifier to update privacy settings for.
string ("link" | "owner" | "participants" | "teammatesandparticipants" | "teammates")
required
New privacy level setting. Available values: ‘link’ (anyone with link can access), ‘owner’ (only meeting owner), ‘participants’ (meeting participants only), ‘teammatesandparticipants’ (teammates and participants), ‘teammates’ (team members only).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FIREFLIES_UPDATE_MEETING_TITLETool to update the title of a meeting transcript. Use when you need to rename a meeting. Requires admin privileges and the meeting owner must be in your team.

Input Parameters

string
required
The unique identifier of the meeting transcript to update.
string
required
The new title to assign to the meeting transcript.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FIREFLIES_UPLOAD_AUDIOThe UploadAudio Action allows you to upload audio files to Fireflies.ai for transcription. Transcription is asynchronous — after submission, results may take several minutes to become available; use transcript retrieval tools to poll for completion. Note: This action requires a paid Fireflies plan to upload and transcribe audio files.

Input Parameters

string
required
The url of media file to be transcribed. It MUST be a valid https string and publicly accessible to enable us download the audio / video file. Double check to see if the media file is downloadable and that the link is not a preview link before making the request. The media file must be either of these formats - mp3, mp4, wav, m4a, ogg
string
Title or name of the meeting, this will be used to identify the transcribed file
string
URL for the webhook that receives notifications when transcription completes
array
An array of objects containing Attendee objects. This is relevant if you have active integrations like Salesforce, Hubspot etc. Fireflies uses the attendees value to push meeting notes to your active CRM integrations where notes are added to an existing contact or a new contact is created. Each object contains - displayName, email, phoneNumber, client_reference_id
boolean
Specify whether the video should be saved or not.
object
Authentication details for accessing protected media files.
string
Specify a custom language code for your meeting, e.g. es for Spanish or de for German. For a complete list of language codes, please view Language Codes
boolean
Set to true to bypass the 50kb minimum file size validation. Useful for processing smaller audio files.
string
The client reference id of the attendee

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not

Triggers

Slug: FIREFLIES_TRANSCRIPTION_COMPLETEType: pollTriggers when a transcription is complete. Polls the Fireflies API over a window anchored to Fireflies’ own transcript dates (not our wall clock) and emits each transcript once (deduped by id), so late, back-dated transcripts are not missed. Handles rate limiting gracefully.

Configuration

number
Periodic Interval to Check for Updates & Send a Trigger in Minutes

Payload

string
Type of transcript event
object
required
The transcript that was completed