curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your_api_key" \
  -d '{
    "query": "mutation($input: AudioUploadInput) { uploadAudio(input: $input) { success title message } }",
    "variables": {
      "input": {
        "url": "https://url-to-the-audio-file",
        "title": "title of the file",
        "attendees": [
          {
            "displayName": "Fireflies Notetaker",
            "email": "notetaker@fireflies.ai",
            "phoneNumber": "xxxxxxxxxxxxxxxx"
          },
          {
            "displayName": "Fireflies Notetaker 2",
            "email": "notetaker2@fireflies.ai",
            "phoneNumber": "xxxxxxxxxxxxxxxx"
          }
        ]
      }
    }
  }' \
  https://api.fireflies.ai/graphql
{
  "data": {
    "uploadAudio": {
      "success": true,
      "title": "title of the file",
      "message": "Uploaded audio has been queued for processing."
    }
  }
}

Overview

The uploadAudio mutation allows you to upload audio files to Fireflies.ai for transcription.

Arguments

input
AudioUploadInput

Usage Example

To upload a file, provide the necessary input parameters to the mutation. Here’s an example of how this mutation could be used:
mutation uploadAudio($input: AudioUploadInput) {
  uploadAudio(input: $input) {
    success
    title
    message
  }
}
curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your_api_key" \
  -d '{
    "query": "mutation($input: AudioUploadInput) { uploadAudio(input: $input) { success title message } }",
    "variables": {
      "input": {
        "url": "https://url-to-the-audio-file",
        "title": "title of the file",
        "attendees": [
          {
            "displayName": "Fireflies Notetaker",
            "email": "notetaker@fireflies.ai",
            "phoneNumber": "xxxxxxxxxxxxxxxx"
          },
          {
            "displayName": "Fireflies Notetaker 2",
            "email": "notetaker2@fireflies.ai",
            "phoneNumber": "xxxxxxxxxxxxxxxx"
          }
        ]
      }
    }
  }' \
  https://api.fireflies.ai/graphql
{
  "data": {
    "uploadAudio": {
      "success": true,
      "title": "title of the file",
      "message": "Uploaded audio has been queued for processing."
    }
  }
}

FAQ

Audio upload only works with publicly accessible URLs. We cannot accept files hosted on your local machine or a private server.

You may use signed urls with short expiry times to upload audio files to Fireflies.ai. Fireflies will download the file from the url and process it.

Error Codes

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

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

The audio file is too short to be processed. Please ensure the audio file is at least 50kb in size.

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

Additional Resources