OSS-first docs
These docs teach the open system first: contracts, generated surfaces, runtimes, governance, and incremental adoption. Studio shows up as the operating layer on top, not as the source of truth.
Fireflies GraphQL API for meeting transcripts, metadata, and webhook events.
Source Definition
export const firefliesIntegrationSpec = defineIntegration({
meta: {
key: 'meeting-recorder.fireflies',
version: '1.0.0',
category: 'meeting-recorder',
title: 'Fireflies.ai Meeting Recorder',
description:
'Fireflies GraphQL API for meeting transcripts, metadata, and webhook events.',
domain: 'productivity',
owners: ['platform.integrations'],
tags: ['meeting-recorder', 'fireflies', 'transcripts'],
stability: StabilityEnum.Experimental,
},
supportedModes: ['byok'],
capabilities: {
provides: [
{ key: 'meeting-recorder.meetings.read', version: '1.0.0' },
{ key: 'meeting-recorder.transcripts.read', version: '1.0.0' },
{ key: 'meeting-recorder.webhooks', version: '1.0.0' },
],
},
configSchema: {
schema: {
type: 'object',
properties: {
baseUrl: {
type: 'string',
description:
'Optional override for the Fireflies GraphQL endpoint. Defaults to https://api.fireflies.ai/graphql.',
},
webhookUrl: {
type: 'string',
description:
'Webhook destination URL configured in Fireflies developer settings.',
},
webhookEvents: {
type: 'array',
items: { type: 'string' },
description:
'Webhook events to subscribe to (e.g., Transcription completed).',
},
transcriptsPageSize: {
type: 'number',
description: 'Number of transcripts to request per GraphQL query.',
},
},
},
example: {
baseUrl: 'https://api.fireflies.ai/graphql',
webhookUrl: 'https://example.com/webhooks/fireflies',
webhookEvents: ['Transcription completed'],
transcriptsPageSize: 25,
},
},
secretSchema: {
schema: {
type: 'object',
required: ['apiKey'],
properties: {
apiKey: {
type: 'string',
description: 'Fireflies API key for GraphQL requests.',
},
webhookSecret: {
type: 'string',
description:
'Optional webhook secret used to verify x-hub-signature HMAC payloads.',
},
},
},
example: {
apiKey: 'fireflies-***',
webhookSecret: 'fireflies-webhook-secret',
},
},
healthCheck: {
method: 'custom',
timeoutMs: 6000,
},
docsUrl: 'https://docs.fireflies.ai/getting-started/introduction',
byokSetup: {
setupInstructions:
'Create a Fireflies API key and optionally configure webhook settings in Developer Settings.',
},
});