Fireflies Node
The Fireflies node provides integration with the Fireflies.ai meeting recording and transcription platform in SkyStudio workflows. You can read meeting transcripts, access summaries and action items, search transcripts, and upload audio files. The connection uses a Fireflies API Key.
Connection Setup and Management
To use the Fireflies node, you must get an API Key from your Fireflies account and add it to SkyStudio.
🎬 Click to watch the video
Getting a Fireflies API Key
- Sign in to fireflies.ai.
- Go to Settings from the profile menu in the lower-left corner or from the top menu.
- Click Fireflies API from the left menu.
- Click the Get API Key button.
- Copy the generated API Key.
Note: Store the API Key in a secure place. You can always return to the Fireflies API page to view your key.
Adding the Connection to SkyStudio
- Go to Application Connections from the left menu in SkyStudio.
- Click the Add New Connection button.
- Select Fireflies as the provider.
- Fill in the following fields:
| Field | Description |
|---|---|
| Connection Name | A descriptive name, such as Company Fireflies |
| API Key | The key you obtained from Fireflies dashboard → API page |
- Click the Save button.
Assigning the Connection to the Node
After adding the Fireflies node to the canvas, select the saved connection from the Application Connections dropdown in the right panel.
Operations
The Fireflies node provides 9 operations:
| Operation | Category | Description |
|---|---|---|
| List Transcripts | Featured | Lists meeting transcripts in the account with a date filter |
| Transcript Details | Featured | Retrieves the full content of a specific transcript |
| Meeting Summary | Featured | Retrieves the AI-generated summary of a meeting |
| Get Action Items | Featured | Lists action items extracted from a meeting |
| Search Transcripts | Featured | Searches all transcripts by keyword |
| Fireflies AI Assistant | Featured | Queries Fireflies data using natural language |
| User Information | Standard | Retrieves user information for the connected account |
| Get Participants | Standard | Retrieves the participant list of a meeting |
| Upload Audio File | Standard | Uploads an external audio file to Fireflies and creates a transcript |
List Transcripts
Lists meeting transcripts in the account with date range and pagination options.
Parameters
| Parameter | Required | Description |
|---|---|---|
| Connection | Yes | The Fireflies connection to use |
| Limit | No | Maximum number of transcripts to return |
| Skip | No | Number of records to skip, used for pagination, such as 10 |
| From Date | No | Start date, such as 2024-06-01 |
| To Date | No | End date, such as 2024-06-30 |
Example Output
{
"transcripts": [
{
"id": "abc123",
"title": "Sprint Review Meeting",
"date": "2024-06-15T10:00:00Z",
"duration": 3600,
"participants": ["ahmet@company.com", "ayse@company.com"]
}
]
}
Transcript Details
Retrieves the full content of a specific meeting transcript, including speaker-based dialogue text.
Parameters
| Parameter | Required | Description |
|---|---|---|
| Connection | Yes | The Fireflies connection to use |
| Transcript ID | Yes | ID of the transcript whose details will be retrieved |
How to Find the Transcript ID
Use the id field from the output of the List Transcripts operation. It is also visible in the URL when you open a transcript in the Fireflies web interface.
Meeting Summary
Retrieves the meeting summary automatically generated by Fireflies AI. It is used to quickly summarize long meetings.
Parameters
| Parameter | Required | Description |
|---|---|---|
| Connection | Yes | The Fireflies connection to use |
| Transcript ID | Yes | ID of the transcript whose summary will be retrieved |
Example Output
{
"summary": {
"overview": "In the Sprint 23 retrospective meeting, team velocity and technical debt were discussed...",
"action_items": ["Prepare a technical debt plan", "Run performance tests"],
"keywords": ["sprint", "retrospective", "technical debt"]
}
}
Get Action Items
Lists action items automatically extracted by Fireflies from a meeting transcript.
Parameters
| Parameter | Required | Description |
|---|---|---|
| Connection | Yes | The Fireflies connection to use |
| Transcript ID | Yes | ID of the transcript whose action items will be retrieved |
Example Output
{
"action_items": [
{
"text": "Ahmet will prepare the design documentation",
"assignee": "ahmet@company.com",
"due_date": null
}
]
}
Search Transcripts
Searches all transcripts by keyword. It is used to find which meeting included a specific conversation.
Parameters
| Parameter | Required | Description |
|---|---|---|
| Connection | Yes | The Fireflies connection to use |
| Search Query | Yes | Keyword or phrase to search for |
| Limit | No | Maximum number of results to return |
Fireflies AI Assistant
Queries Fireflies data using natural language. As shown in the video, you can write free-text queries such as “get the title of the last meeting”.
Parameters
| Parameter | Required | Description |
|---|---|---|
| Connection | Yes | The Fireflies connection to use |
| Query | Yes | Fireflies query in natural language |
| System Prompt | No | System instruction that customizes the AI assistant’s behavior |
Usage Example
Query: "Get the title of my last meeting"
System Prompt: "Consider only meetings from the last 7 days. Respond in Turkish."
User Information
Returns profile information for the connected Fireflies account.
Parameters
| Parameter | Required | Description |
|---|---|---|
| Connection | Yes | The Fireflies connection to use |
Get Participants
Returns the participant list of a specific meeting, including names and email addresses.
Parameters
| Parameter | Required | Description |
|---|---|---|
| Connection | Yes | The Fireflies connection to use |
| Transcript ID | Yes | ID of the transcript whose participants will be retrieved |
Upload Audio File
Sends the URL of an external audio or video file to Fireflies to start automatic transcript generation.
Parameters
| Parameter | Required | Description |
|---|---|---|
| Connection | Yes | The Fireflies connection to use |
| Audio URL | Yes | Publicly accessible URL of the audio file, such as mp3, mp4, m4a, or wav |
| Meeting Title | Yes | Title of the transcript to be created |
| Meeting Link optional | No | Related meeting link, such as a Zoom, Teams, or Meet URL |
Note: The audio file URL must be accessible by Fireflies servers. Private URLs or URLs that require authentication will not work.
Quick Start Examples
Example 1: Weekly Meeting Summary Report
A workflow that sends summaries of last week’s meetings to Slack:
Schedule (Every Monday) → List Transcripts → Meeting Summary → LLM (combine) → Send Channel Message (Slack)
List Transcripts settings:
- From Date:
{{last_week_start}} - To Date:
{{last_week_end}} - Limit:
10
Example 2: Action Item Tracking
A workflow that converts meeting action items into Jira issues automatically:
List Transcripts → Get Action Items → Create Issue (Jira)
Get Action Items settings:
- Transcript ID:
{{transcripts.results[0].id}}
Create Issue settings:
- Summary:
[Meeting] {{action_item.text}} - Assignee:
{{action_item.assignee}}
Example 3: Fireflies AI Chatbot
A chatbot that allows users to query meeting content using natural language:
Text Input → Fireflies AI Assistant → Text Output
Fireflies AI Assistant settings:
- Query:
{{input.text}} - System Prompt:
"You are the company’s meeting assistant. Use Fireflies transcripts and provide short answers in Turkish."
Example 4: Audio Recording Transcription Automation
A workflow that automatically transcribes audio files uploaded to a storage location:
Webhook (file uploaded) → Upload Audio File → Slack Notification
Upload Audio File settings:
- Audio URL:
{{webhook.file_url}} - Meeting Title:
{{webhook.file_name}}
Common Errors
| Error | Possible Cause | Solution |
|---|---|---|
401 Unauthorized | API Key is invalid | Check the API Key from Fireflies dashboard → API page |
404 Not Found | Invalid Transcript ID | Find the correct ID using the List Transcripts operation |
| Empty transcript list | No records in the specified date range | Expand the From Date / To Date range |
| Audio upload failed | URL is not accessible | Make sure the audio file is publicly accessible |
| Empty summary | The meeting has not been processed yet | Fireflies may take a few minutes to create the transcript; run the workflow with a delay |
Notes
- Fireflies API uses GraphQL API to access meeting records. Transcript IDs can be obtained from the List Transcripts operation.
- Meeting summaries and action items are generated automatically by Fireflies AI. Results may vary depending on the meeting content.
- Files uploaded with the Upload Audio File operation may take a few minutes to become transcripts. Add a delay to the workflow to check whether the transcript is ready.
- API access may be limited on the Fireflies free plan. For heavy usage, you may need to upgrade to the Pro or Business plan.
- When the API Key needs to be renewed, remember to update the connection in SkyStudio as well.