Add to Live

Use the API to add the Fireflies.ai bot to an ongoing meeting

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

meeting_link · String! · required

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 automatically

Maximum 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 provided

Minimum 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 Codes

Maximum 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

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

Response

{
  "data": {
    "addToLiveMeeting": {
      "success": true,
    }
  }
}

FAQ

Why am I getting a 'too_many_requests' error?

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.

too_many_requests

You have exceeded the rate limit for the addToLiveMeeting mutation. It is limited to 3 requests per 20 minutes. Please try again later.

invalid_language_code

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

unsupported_platform

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