Fireflies.ai Common Errors

Overview

Quick reference for all Fireflies.ai GraphQL API error codes with root causes and fixes.

Error Response Format

All Fireflies errors follow this GraphQL error structure:

{
  "errors": [{
    "message": "Human-readable description",
    "code": "error_code",
    "friendly": true,
    "extensions": {
      "status": 400,
      "helpUrls": ["https://docs.fireflies.ai/..."]
    }
  }]
}

Error Code Reference

auth_failed

(401)

Message: Invalid or missing API key.

# Verify API key is set and valid
echo "Key set: ${FIREFLIES_API_KEY:+YES}"

# Test authentication
set -euo pipefail
curl -s -X POST https://api.fireflies.ai/graphql \
  -H "Authorization: Bearer $FIREFLIES_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "{ user { email } }"}' | jq .

Fix: Regenerate API key at app.fireflies.ai > Integrations > Fireflies API.

too_many_requests

(429)

Message: Rate limit exceeded.

Fix: Implement exponential backoff. See

fireflies-rate-limits

require_ai_credits

(402)

Message: AskFred operations require AI credits. Fix: Visit Fireflies dashboard > Upgrade section to purchase AI credits. Budget for

createAskFredThread

continueAskFredThread

account_cancelled

(403)

Message: Subscription inactive. Fix: Renew your Fireflies subscription or switch to a different API key.

invalid_language_code

(400)

Message: Unsupported language code in

uploadAudio

addToLiveMeeting

en

es

de

fr

ja

unsupported_platform

(400)

Message: Meeting platform not recognized by

addToLiveMeeting

meeting_link

payload_too_small

(400)

Message: Uploaded audio file is below 50KB minimum. Fix: Set

bypass_size_check: true

AudioUploadInput

await firefliesQuery(`
  mutation($input: AudioUploadInput) {
    uploadAudio(input: $input) { success title message }
  }
`, {
  input: {
    url: "https://example.com/short-clip.mp3",
    bypass_size_check: true,
  },
});

GraphQL Validation Errors (400)

Message: Field or argument not found in schema.

# Introspect the schema to discover available fields
set -euo pipefail
curl -s -X POST https://api.fireflies.ai/graphql \
  -H "Authorization: Bearer $FIREFLIES_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "{ __schema { queryType { fields { name description } } } }"}' | jq '.data.__schema.queryType.fields[] | {name, description}'

Network / Connection Errors

ECONNREFUSED

api.fireflies.ai

ETIMEDOUT

api.fireflies.ai

ENOTFOUND

8.8.8.8

Quick Diagnostic Script

set -euo pipefail
echo "=== Fireflies.ai Diagnostics ==="
echo "API Key: ${FIREFLIES_API_KEY:+SET (${#FIREFLIES_API_KEY} chars)}"
echo ""

# Connectivity
echo "--- Connectivity ---"
curl -s -o /dev/null -w "HTTP %{http_code} in %{time_total}s\n" \
  -X POST https://api.fireflies.ai/graphql \
  -H "Authorization: Bearer $FIREFLIES_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "{ user { email } }"}'

# Full response
echo ""
echo "--- Auth Check ---"
curl -s -X POST https://api.fireflies.ai/graphql \
  -H "Authorization: Bearer $FIREFLIES_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "{ user { name email is_admin } }"}' | jq .

Deprecated Fields

These fields still work but will be removed:

transcript.host_email

transcript.organizer_email

transcripts(date: ...)

transcripts(fromDate: ..., toDate: ...)

transcripts(title: ...)

transcripts(keyword: ..., scope: ...)

transcripts(organizer_email: ...)

transcripts(organizers: [...])

transcripts(participant_email: ...)

transcripts(participants: [...])

Output

• Error code identified with root cause
• Fix applied and verified
• Deprecated field warnings resolved

Resources

• Fireflies API Docs
• Fireflies Introspection
• Fireflies API Concepts

Next Steps

For comprehensive debugging, see

fireflies-debug-bundle