Webhooks - Corsair

The Fireflies plugin handles incoming webhooks. Point your provider’s subscription URL at your Corsair HTTP handler (see Overview for setup context and the exact URL shape).

New to Corsair? See webhooks and hooks.

Webhook map

meetings
- inMeeting (meetings.inMeeting)
- meetingDeleted (meetings.meetingDeleted)
- newMeeting (meetings.newMeeting)
transcriptions
- transcriptionComplete (transcriptions.transcriptionComplete)
- transcriptProcessing (transcriptions.transcriptProcessing)

HTTP handler setup

app/api/webhook/route.ts

import { processWebhook } from "corsair";
import { corsair } from "@/server/corsair";

export async function POST(request: Request) {
    const headers = Object.fromEntries(request.headers);
    const body = await request.json();
    const result = await processWebhook(corsair, headers, body);
    return result.response;
}

Events

Meetings

In Meeting

meetings.inMeeting Fireflies bot has joined a meeting Payload

Name	Type	Required	Description
`meetingId`	`string`	Yes	—
`clientReferenceId`	`string`	No	—
`eventType`	`InMeeting`	Yes	—

Response data full type

{
  meetingId: string,
  clientReferenceId?: string | null,
  eventType: InMeeting
}

webhookHooks example

fireflies({
    webhookHooks: {
        meetings: {
            inMeeting: {
                before(ctx, args) {
                    return { ctx, args };
                },
                after(ctx, response) {
                },
            },
        },
    },
})

Meeting Deleted

meetings.meetingDeleted A meeting has been deleted Payload

Name	Type	Required	Description
`meetingId`	`string`	Yes	—
`clientReferenceId`	`string`	No	—
`eventType`	`MeetingDeleted`	Yes	—

Response data full type

{
  meetingId: string,
  clientReferenceId?: string | null,
  eventType: MeetingDeleted
}

webhookHooks example

fireflies({
    webhookHooks: {
        meetings: {
            meetingDeleted: {
                before(ctx, args) {
                    return { ctx, args };
                },
                after(ctx, response) {
                },
            },
        },
    },
})

New Meeting

meetings.newMeeting A new meeting has been detected Payload

Name	Type	Required	Description
`meetingId`	`string`	Yes	—
`clientReferenceId`	`string`	No	—
`eventType`	`NewMeeting`	Yes	—

Response data full type

{
  meetingId: string,
  clientReferenceId?: string | null,
  eventType: NewMeeting
}

webhookHooks example

fireflies({
    webhookHooks: {
        meetings: {
            newMeeting: {
                before(ctx, args) {
                    return { ctx, args };
                },
                after(ctx, response) {
                },
            },
        },
    },
})

Transcriptions

Transcription Complete

transcriptions.transcriptionComplete Transcription is complete and available Payload

Name	Type	Required	Description
`meetingId`	`string`	Yes	—
`clientReferenceId`	`string`	No	—
`eventType`	`Transcription`	Yes	—

Response data full type

{
  meetingId: string,
  clientReferenceId?: string | null,
  eventType: Transcription
}

webhookHooks example

fireflies({
    webhookHooks: {
        transcriptions: {
            transcriptionComplete: {
                before(ctx, args) {
                    return { ctx, args };
                },
                after(ctx, response) {
                },
            },
        },
    },
})

Transcript Processing

transcriptions.transcriptProcessing Transcript is being processed Payload

Name	Type	Required	Description
`meetingId`	`string`	Yes	—
`clientReferenceId`	`string`	No	—
`eventType`	`TranscriptProcessing`	Yes	—

Response data full type

{
  meetingId: string,
  clientReferenceId?: string | null,
  eventType: TranscriptProcessing
}

webhookHooks example

fireflies({
    webhookHooks: {
        transcriptions: {
            transcriptProcessing: {
                before(ctx, args) {
                    return { ctx, args };
                },
                after(ctx, response) {
                },
            },
        },
    },
})

​Webhook map

​HTTP handler setup

​Events

​Meetings

​In Meeting

​Meeting Deleted

​New Meeting

​Transcriptions

​Transcription Complete

​Transcript Processing

Webhook map

HTTP handler setup

Events

Meetings

In Meeting

Meeting Deleted

New Meeting

Transcriptions

Transcription Complete

Transcript Processing