Skip to main content

Overview

The addToLiveMeeting mutation allows you to add the Fireflies.ai bot to an ongoing meeting. It is rate limited to 3 requests per 20 minutes per user; on Business and Enterprise plans the team shares a pool of 3 requests per paid seat per 20 minutes, up to 60, of which a single user can use at most half (rounded up, never less than 3).

Arguments

A valid http URL for the meeting link, i.e. gooogle meet, zoom, etc
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 automaticallyMaximum length is 256 characters.
String
Password for the meeting, if applicable.Maximum length is 32 characters.
Int
Meeting duration in minutes. Defaults to 60 minutes if param is not providedMinimum is 15 and maximum is 120.
String
Language of the meeting. Defaults to English if not provided. For a complete list of language codes, please view Language CodesMaximum length is 5 characters.
[Attendee]
Array of Attendees for expected meeting participants.

Usage Example

To upload an audio file, provide the necessary input parameters to the mutation. Here’s an example of how this mutation could be used:

FAQ

The addToLiveMeeting mutation has a limit of 3 requests per 20 minutes per user. Business and Enterprise teams share a pool of 3 requests per paid seat per 20 minutes (up to 60), so another team member’s calls count against the same pool; a single user can use at most half of it (rounded up, never less than 3).

You may view API Rate limits here.

Error Codes

List of possible error codes that may be returned by the addToLiveMeeting mutation. Full list of error codes can be found here.

You have exceeded the rate limit for the addToLiveMeeting mutation: 3 requests per 20 minutes per user, or your team’s pooled allowance on Business and Enterprise. Wait for the number of seconds in the Retry-After header before retrying; extensions.metadata.retryAfter in the error body gives the same moment as an epoch timestamp in milliseconds.

The language code you provided is invalid. Please refer to the Language Codes page for a list of valid language codes.

The meeting platform URL provided is not supported. Please use a supported meeting platform such as Zoom, Google Meet, Microsoft Teams, etc.

Additional Resources

Upload Audio

Use the API to upload audio to Fireflies.ai

Webhooks

Create notifications using webhooks