Fireflies Integration Guide


November 5, 2025

Fireflies Integration Guide

Learn how to connect Fireflies.ai to your application using Unified.to.

This guide covers how to enable the integration, embed the authorization component, and verify the connection end-to-end.

Overview

The Fireflies integration allows your app's end users to authorize Unified.to to access their Fireflies accounts for meeting recordings and user data.

Once connected, your application can access the Fireflies API securely through Unified.to — without your users ever leaving your app.

Prerequisites

Before getting started, ensure you have:

  • A Unified.to developer account and active API credentials
  • Your end-customer has a Fireflies.ai paid plan (API access required)
  • Access to your app's frontend or backend to embed the Unified.to authorization component so that you can get your end-customer to authorize access to Fireflies
  • Optional: API Explorer or MCP Server for testing connections

Please note that the Fireflies API is only available to users on a paid Fireflies plan. Free-tier accounts cannot authorize API access.

Step-by-Step Setup

1. Enable the Fireflies Integration in Unified.to

  1. Log in to your Unified.to developer dashboard.
  2. Navigate to Integrations.
  3. Locate Fireflies in the catalog.
  4. Click Activate Integration.

Once enabled, Fireflies becomes available for your end-customer to authorize within your own app.


2. Embed the Authorization Component

Use the Embedded Authorization (Authorize Optimization) component from Unified.to to create a seamless in-app experience.

  1. Add the component to your application UI where users connect integrations.
  2. Preview the embedded experience - this is what your customers see when connecting Fireflies.
  3. The component displays a button (e.g., "Authorize Fireflies") and short instructions.

3. Obtain the Fireflies API Key

Your end-customers/users will need their Fireflies API key to complete authorization.

Steps for your end user:

  1. Log in to their Fireflies.ai account.
  2. Go to Settings → Integrations.
  3. Locate API Key and click Copy.
  4. Return to your app's authorization screen and paste it into the field provided.

4. Authorize Access

  1. In the authorization window, paste the Fireflies API key.
  2. Click Authorize.
  3. Unified.to will automatically:
    • Validate the API key
    • Connect to Fireflies
    • Run a test connection

If successful, Unified.to creates a new Connection Object linked to that customer.


5. Verify the Connection

Once the test passes, a new connection record appears in your Unified.to dashboard.

FieldDescription
Connection IDUnique identifier for API requests
IntegrationFireflies.ai
StatusConnected
Created AtTimestamp of creation

Use the Connection ID to make authenticated API calls to Fireflies through Unified.to.


6. Test the Connection (Optional)

You can test the integration in two environments:

a) Using Unified.to API Explorer

  • Open API Explorer in your dashboard.
  • Use your new Connection ID to query endpoints such as:
    • /hris/{id}/employee – list Fireflies users
    • /calendar/{id}/recording – retrieve meeting data

b) Using MCP Server (for AI Agents)

If your use case involves AI agents, test the connection within your MCP Server using the same Connection ID.


Example Use Cases

  • Retrieve meeting recordings for transcription or analysis
  • Sync Fireflies user data into your CRM or analytics system
  • Feed Fireflies meeting data into AI summarization or tagging workflows

Troubleshooting

IssueDescriptionSolution
Authorization failedInvalid or expired API keyRe-copy the key from Fireflies and retry authorization.
Test connection failedAPI access not enabledEnsure user is on a paid Fireflies plan.
No data returnedKey valid but no accessible dataCheck that the Fireflies workspace contains recordings.

*Fireflies must have existing data (e.g., recorded meetings) to return results when testing API endpoints.


Next Steps

  • Explore the Unified.to API Reference to interact with /hris/{id}/employee and /calendar/{id}/recording.
  • Monitor performance and connection status under Integration Health in your dashboard.
  • Repeat these steps for other integrations or customer environments.


Last updated: November 2025

Share
Are we missing anything? Let us know
Was this page helpful?