Create Upload URL

Generate a pre-signed URL for direct audio/video file uploads

This API is not generally available. Access requires whitelisting. Please contact Fireflies support to request access.

Overview

The createUploadUrl mutation generates a pre-signed URL that allows you to upload audio or video files directly to Fireflies.ai storage. This is useful when you want to upload files from your own infrastructure without exposing them via a public URL.

This mutation is part of a two-step upload flow:

1. Call createUploadUrl to get a pre-signed upload URL
2. Upload your file directly to the URL using an HTTP PUT request
3. Call confirmUpload to confirm the upload and start transcription

Arguments

input · CreateUploadUrlInput · required

Show child attributes

content_type · String · required

The MIME type of the file being uploaded. Must be one of the supported audio or video formats. See Supported Content Types below.

file_size · Int · required

The size of the file in bytes. Used for validation against plan limits. Maximum 2GB for video files (paid users) or 400MB for audio files.

title · String

Title or name of the meeting. This will be used to identify the transcribed file. Maximum 256 characters.

custom_language · 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. Maximum 5 characters.

attendees · [Attendee]

An array of 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. Maximum 100 attendees.

Response

upload_url · String

The pre-signed URL to upload your file to. Use an HTTP PUT request with the file content as the body.

meeting_id · String

The unique identifier for the meeting. Use this ID when calling confirmUpload.

expires_at · String

ISO 8601 timestamp indicating when the upload URL expires. URLs are valid for 1 hour.

Usage Example

mutation createUploadUrl($input: CreateUploadUrlInput!) {
  createUploadUrl(input: $input) {
    upload_url
    meeting_id
    expires_at
  }
}

curl

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your_api_key" \
  -d '{
    "query": "mutation($input: CreateUploadUrlInput!) { createUploadUrl(input: $input) { upload_url meeting_id expires_at } }",
    "variables": {
      "input": {
        "content_type": "audio/mpeg",
        "file_size": 10485760,
        "title": "Team Meeting Recording"
      }
    }
  }' \
  https://api.fireflies.ai/graphql

Response

{
  "data": {
    "createUploadUrl": {
      "upload_url": "https://storage.googleapis.com/...",
      "meeting_id": "abc123def456",
      "expires_at": "2024-01-15T12:00:00.000Z"
    }
  }
}

Uploading the File

After receiving the signed URL, upload your file using an HTTP PUT request:

curl -X PUT \
  -H "Content-Type: audio/mpeg" \
  --data-binary @your-audio-file.mp3 \
  "https://storage.googleapis.com/..."

const fs = require('fs');
const axios = require('axios');

const fileBuffer = fs.readFileSync('your-audio-file.mp3');

await axios.put(uploadUrl, fileBuffer, {
  headers: {
    'Content-Type': 'audio/mpeg'
  }
});

with open('your-audio-file.mp3', 'rb') as f:
    file_data = f.read()

response = requests.put(
    upload_url,
    data=file_data,
    headers={'Content-Type': 'audio/mpeg'}
)

After the upload completes successfully, call confirmUpload to start transcription.

Supported Content Types

Audio Formats

MIME Type	Extension
audio/mpeg	.mp3
audio/mp3	.mp3
audio/wav	.wav
audio/x-wav	.wav
audio/vnd.wave	.wav
audio/x-m4a	.m4a
audio/mp4	.m4a
audio/ogg	.ogg
audio/webm	.webm
audio/aac	.aac
audio/x-aac	.aac
audio/aac-adts	.aac
audio/amr	.amr
audio/opus	.opus
audio/3gpp	.3gp

Video Formats

MIME Type	Extension
video/mp4	.mp4
video/webm	.webm
video/quicktime	.mov
video/x-m4v	.m4v
video/mpeg	.mpeg
video/x-msvideo	.avi
video/ogg	.ogv
video/3gpp	.3gp

File Size Limits

File Type	User Plan	Maximum Size
Audio	All plans	400 MB
Video	Free	200 MB
Video	Paid	2 GB

Error Codes

paid_required

This mutation requires a paid plan (Pro or higher). Free plan users cannot use direct file uploads.

invalid_arguments

The content type is not supported, or the file size exceeds the allowed limit for your plan.

Additional Resources

Confirm Upload

Confirm the upload and start transcription

Upload Audio (URL)

Alternative: Upload audio via public URL

Webhooks

Receive notifications when transcription completes

Language Codes

Supported language codes for transcription