Skip to main content
curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your_api_key" \
  -d '{
    "query": "mutation AddToLiveMeeting($meetingLink: String!) { addToLiveMeeting(meeting_link: $meetingLink) { success } }",
    "variables": {
      "meetingLink": "https://meet.google.com/code-here"
    }
  }' \
  https://api.fireflies.ai/graphql
{
  "data": {
    "addToLiveMeeting": {
      "success": true,
    }
  }
}

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.

Arguments

A valid http URL for the meeting link, i.e. gooogle meet, zoom, etc
title
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.
meeting_password
String
Password for the meeting, if applicable.Maximum length is 32 characters.
duration
Int
Meeting duration in minutes. Defaults to 60 minutes if param is not providedMinimum is 15 and maximum is 120.
language
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.
attendees
[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:
mutation AddToLiveMeeting($meetingLink: String!) {
  addToLiveMeeting(meeting_link: $meetingLink) {
    success
  }
}
curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your_api_key" \
  -d '{
    "query": "mutation AddToLiveMeeting($meetingLink: String!) { addToLiveMeeting(meeting_link: $meetingLink) { success } }",
    "variables": {
      "meetingLink": "https://meet.google.com/code-here"
    }
  }' \
  https://api.fireflies.ai/graphql
{
  "data": {
    "addToLiveMeeting": {
      "success": true,
    }
  }
}

FAQ

The addToLive mutation has a limit of 3 requests per 20 minutes.

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. It is limited to 3 requests per 20 minutes. Please try again later.

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

The user account has been cancelled. Please contact support if you encounter this error.

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

Additional Resources