> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Fireflies.ai Webhook Setup Guide

> Configure Fireflies.ai to deliver events to StackOne.

## Prerequisites

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

<Steps>
  <Step title="Configure the Connector">
    Enable the connector and set up its connector profile in your project. See <a href="/guides/explore-connectors">Managing Connectors</a>.

    <Columns cols={2}>
      <Card title="Connector Profile" href="/connectors/fireflies/guides/connector-profile/api-token" icon="https://stackone-logos.com/api/fireflies/filled/png" horizontal>
        Fireflies.ai - API Token
      </Card>
    </Columns>
  </Step>

  <Step title="Link an Account">
    Connect an account using <a href="/guides/embedding-stackone-hub">StackOne Hub</a> or <a href="/guides/auth-link">Auth Link</a>.

    <Columns cols={2}>
      <Card title="Link Account" href="/connectors/fireflies/guides/link-account/api-token" icon="https://stackone-logos.com/api/fireflies/filled/png" horizontal>
        Fireflies.ai - API Token
      </Card>
    </Columns>
  </Step>
</Steps>

<section data-guide-section data-guide-scopes="">
  <h2>Webhook setup</h2>

  <p>This connector uses <strong>Manual Webhooks</strong>. 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 <strong>Webhooks</strong> integration page for this — the older webhook field under Settings > Developer Settings is deprecated by Fireflies in favor of this page.</p>

  <Steps>
    <Step title="Copy the StackOne webhook URL">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>In StackOne, open the connected account and copy the <strong>Native Webhook URL</strong> shown on the connection. This is the URL Fireflies will deliver events to.</p>
      </div>
    </Step>

    <Step title="Open the Webhooks integration page">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Log in to <a href="https://app.fireflies.ai" target="_blank" rel="noopener noreferrer">Fireflies dashboard</a> and open the <a href="https://app.fireflies.ai/integrations/api/webhook" target="_blank" rel="noopener noreferrer">Webhooks integration page</a>. On the <strong>Configurations</strong> tab, click <strong>+ Configure</strong>.</p>

        <img src="https://mintlify.s3.us-west-1.amazonaws.com/stackone-60/connectors/images/events-create-configuration.png" alt="Fireflies Webhooks integration page with the Configure button highlighted" />
      </div>
    </Step>

    <Step title="Fill in the webhook configuration">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>A <strong>Webhook Configuration</strong> panel opens with three fields.</p>

        <ul>
          <li><strong>Webhook URL</strong> — paste the StackOne <strong>Native Webhook URL</strong> for this connected account</li>
          <li><strong>Signing Secret (optional)</strong> — leave empty, or enter a 16-32 character secret</li>
          <li>Under <strong>Event Subscriptions</strong>, select <strong>Meeting Transcribed</strong>, <strong>Meeting Summarized</strong> and <strong>Meeting Bot Joined</strong> so all events are delivered</li>
        </ul>

        <img src="https://mintlify.s3.us-west-1.amazonaws.com/stackone-60/connectors/images/events-webhook-configuration.png" alt="Webhook Configuration panel with the Webhook URL filled and the Meeting Transcribed, Meeting Summarized and Meeting Bot Joined events selected" />
      </div>
    </Step>

    <Step title="Test the webhook">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Click <strong>Continue</strong>. Under <strong>Test Webhook</strong>, click <strong>Send Test Event</strong> to fire a test delivery to the URL — StackOne acknowledges it automatically. This step is optional but confirms the URL is reachable.</p>

        <img src="https://mintlify.s3.us-west-1.amazonaws.com/stackone-60/connectors/images/events-send-test-event.png" alt="Test Webhook step with the Send Test Event button highlighted" />
      </div>
    </Step>

    <Step title="Save the configuration">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Click <strong>Save</strong>. The new configuration appears in the <strong>Configurations</strong> list with its toggle enabled — events now flow to StackOne.</p>

        <img src="https://mintlify.s3.us-west-1.amazonaws.com/stackone-60/connectors/images/events-configuration-saved.png" alt="Configurations list showing the saved configuration with its toggle enabled" />
      </div>
    </Step>
  </Steps>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Available webhook events</h2>

  <p>The following events are emitted by this connector once the webhook is configured.</p>

  <Steps>
    <Step title="Meeting events">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Events describing the lifecycle of a recorded meeting.</p>

        <ul>
          <li><strong>Transcription Completed</strong> (`transcript.completed`) — Fired when a meeting finishes processing and its transcript becomes available</li>
          <li><strong>Meeting Summarized</strong> (`transcript.summarized`) — Fired when the AI summary for a processed meeting is ready</li>
          <li><strong>Meeting Bot Joined</strong> (`meeting.bot_joined`) — Fired when the Fireflies notetaker bot joins a live meeting</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Delivery format</h2>

  <p>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 <strong>Send Test Event</strong> button fires a synthetic test payload, which StackOne acknowledges without emitting an event.</p>
</section>

## 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.