View as Markdown
Fireflies icon

Fireflies ACTION

Create Meeting Clip

Create a clip (a Fireflies "bite") from a completed, already-transcribed meeting by specifying a start and end time in seconds. This is the action to use for past meetings — for a meeting that is still running, use Create Live Meeting Soundbite instead. To find the moment to clip, read the sentences array returned by Find Meeting by ID: each sentence carries its own start_time and end_time in seconds (e.g. 142.5), so clipping around a quote means passing that sentence's start and end. Clip generation is asynchronous — this returns immediately with status: pending and no media, so preview, thumbnail and the playable URL are not available yet. Pass the returned id to Find Clip by ID and poll until status reaches a terminal ready or error. See the documentation
  • Action
  • Writes data
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Fireflies account once, then configure and run Create Meeting Clip from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "fireflies-create-meeting-clip",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    fireflies: { authProvisionId: "apn_xxxxxxx" },
    meetingId: "Meeting ID",
    startTime: "Start Time",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Create Meeting Clip inputs
Property Type Description
meetingId Meeting ID string
The completed meeting to clip. A Fireflies meeting ID and transcript ID are the same value. Use Find Meeting by ID or Find Recent Meeting to look up a meeting ID.
Required Dynamic
startTime Start Time string
Where the clip starts, in seconds from the beginning of the meeting, e.g. 142.5. Fractional seconds are allowed, using a dot as the decimal separator. Thousands separators are ignored, so 1,200 is read as 1200 seconds. Copy the start_time of a sentence returned by Find Meeting by ID to clip around a specific quote.
Required
endTime End Time string
Where the clip ends, in seconds from the beginning of the meeting, e.g. 168.25. Uses a dot as the decimal separator and ignores thousands separators, the same as Start Time. Must be greater than Start Time.
Required
name Name string
A title for the clip, e.g. Pricing objection. Max 256 characters.
Optional
mediaType Media Type string
Whether to produce a video or audio clip. A video clip is only possible if the meeting itself was recorded with video.
Optional
privacies Privacies string[]
Who can view the clip. public is viewable by anyone with the link, team by your Fireflies team, and participants by the meeting's attendees.
Optional
summary Summary string
A short description of what the clip contains, e.g. Customer pushes back on the enterprise tier price. Max 500 characters.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
fireflies-create-meeting-clip
Version
0.0.2
App
Fireflies
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes