--- title: "Fireflies Integration Guide" img: https://s3.us-east-2.amazonaws.com/unified-article-images/fireflies_integration_guide-icon.jpg date: 2025-11-05T00:00:00.000Z tag: Guides description: "Learn how to connect an end-customer's Fireflies.ai account to your application using Unified.to." url: "https://docs.unified.to/guides/fireflies_integration_guide" --- # Fireflies Integration Guide ------ _November 5, 2025_ # Fireflies Integration Guide Learn how to connect an end-customer's [**Fireflies.ai**](https://fireflies.ai/) account to your application using [**Unified.to**](https://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](https://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](https://unified.to/) — without your users ever leaving your app. ## Prerequisites Before getting started, ensure you have: - A [**Unified.to**](https://unified.to/) **developer account** and active API credentials - Your end-customer has a [**Fireflies.ai**](https://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](https://unified.to/) 1. Log in to your [Unified.to](https://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](https://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**](https://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](https://unified.to/) will automatically: - Validate the API key - Connect to Fireflies - Run a **test connection** If successful, [Unified.to](https://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](https://unified.to/) dashboard. | Field | Description | | ----------------- | ------------------------------------ | | **Connection ID** | Unique identifier for API requests | | **Integration** | [Fireflies.ai](https://fireflies.ai/) | | **Status** | Connected | | **Created At** | Timestamp of creation | Use the **Connection ID** to make authenticated API calls to Fireflies through [Unified.to](https://unified.to/). --- ### 6. Test the Connection (Optional) You can test the integration in two environments: a) Using [Unified.to](https://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 | Issue | Description | Solution | | -------------------------- | -------------------------------- | ------------------------------------------------------- | | **Authorization failed** | Invalid or expired API key | Re-copy the key from Fireflies and retry authorization. | | **Test connection failed** | API access not enabled | Ensure user is on a paid Fireflies plan. | | **No data returned** | Key valid but no accessible data | Check 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](https://www.notion.so/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. --- ## Related Articles - [Embedding the Authorization Component](https://www.notion.so/guides/embedded-authorization) - [Testing Connections via API Explorer](https://www.notion.so/guides/testing-connections) - [Managing Customer Connections](https://www.notion.so/guides/manage-connections) --- _Last updated: November 2025_