Skip to main content

​
Prerequisites

Before continuing, you should have already completed the following for this connector:
1

Configure the Connector

Enable the connector and set up its connector profile in your project. See Managing Connectors.

Connector Profile

Fireflies.ai - API Token
2

Link an Account

Connect an account using StackOne Hub or Auth Link.

Link Account

Fireflies.ai - API Token

​
Webhook setup

This connector uses Manual Webhooks. Fireflies.ai has no public webhook management API, so the webhook is configured once in the Fireflies dashboard using the StackOne webhook URL. Use the Webhooks integration page for this — the older webhook field under Settings > Developer Settings is deprecated by Fireflies in favor of this page.

1

Copy the StackOne webhook URL

In StackOne, open the connected account and copy the Native Webhook URL shown on the connection. This is the URL Fireflies will deliver events to.

2

Open the Webhooks integration page

Log in to Fireflies dashboard and open the Webhooks integration page. On the Configurations tab, click + Configure.

Fireflies Webhooks integration page with the Configure button highlighted
3

Fill in the webhook configuration

A Webhook Configuration panel opens with three fields.

  • Webhook URL — paste the StackOne Native Webhook URL for this connected account
  • Signing Secret (optional) — leave empty, or enter a 16-32 character secret
  • Under Event Subscriptions, select Meeting Transcribed, Meeting Summarized and Meeting Bot Joined so all events are delivered
Webhook Configuration panel with the Webhook URL filled and the Meeting Transcribed, Meeting Summarized and Meeting Bot Joined events selected
4

Test the webhook

Click Continue. Under Test Webhook, click Send Test Event to fire a test delivery to the URL — StackOne acknowledges it automatically. This step is optional but confirms the URL is reachable.

Test Webhook step with the Send Test Event button highlighted
5

Save the configuration

Click Save. The new configuration appears in the Configurations list with its toggle enabled — events now flow to StackOne.

Configurations list showing the saved configuration with its toggle enabled

​
Available webhook events

The following events are emitted by this connector once the webhook is configured.

1

Meeting events

Events describing the lifecycle of a recorded meeting.

  • Transcription Completed (transcript.completed) — Fired when a meeting finishes processing and its transcript becomes available
  • Meeting Summarized (transcript.summarized) — Fired when the AI summary for a processed meeting is ready
  • Meeting Bot Joined (meeting.bot_joined) — Fired when the Fireflies notetaker bot joins a live meeting

​
Delivery format

Fireflies sends one HTTP POST per event as a flat JSON body containing the event name, an epoch-milliseconds timestamp and the meeting identifier (usable as the transcript ID with the transcripts API). Every delivery carries an x-webhook-delivery-id header. When a Signing Secret is configured, deliveries are signed with an HMAC-SHA256 signature in the x-hub-signature header. The Send Test Event button fires a synthetic test payload, which StackOne acknowledges without emitting an event.

​
Verify

Your Connector should now be able to receive and process events. Try triggering an event and you should see an Event appear in the Connector logs.