Integrations

Connected publishing tools and notetaker providers for the API key owner.

GET/api/v1/account

Get Account

Returns the API key owner's available processing time and how many requests remain in the current 24-hour rate-limit window. Useful for monitoring scripts before creating projects.

Response 200

json

{
  "plan": "pro",
  "unlimited_processing": false,
  "processing_minutes": 240,
  "subscription_included_minutes": 240,
  "overage_minutes": 0,
  "rate_limit": {
    "reads": {
      "limit_per_24h": 2000,
      "used_today": 12,
      "remaining_today": 1988,
      "resets_at": "2026-06-10T15:09:33.998Z"
    },
    "writes": {
      "limit_per_24h": 100,
      "used_today": 3,
      "remaining_today": 97,
      "resets_at": "2026-06-10T15:09:33.998Z"
    }
  }
}

processing_minutes is your available processing time (plan allowance plus bonus minutes). Pro accounts include 240 minutes of plan processing time per seat per month on the $97/month subscription. Check processing_minutes before POST/projects - a 402 means insufficient processing time. rate_limit.reads and rate_limit.writes track GET vs POST/PATCH/DELETE headroom separately.

GET/api/v1/integrations

List Integrations

List publishing tools and notetaker providers connected to the API key owner's account. Secrets are never returned. Use publishing providers when approving posts with PATCH/projects/:id/posts/:postId.

Response 200

json

{
  "integrations": [
    { "provider": "linkedin", "connected_at": "2026-05-01T10:00:00Z", "kind": "publishing" },
    { "provider": "fireflies", "connected_at": "2026-06-01T12:00:00Z", "kind": "notetaker" },
    { "provider": "fathom", "connected_at": "2026-06-15T12:00:00Z", "kind": "notetaker" },
    { "provider": "granola", "connected_at": "2026-06-18T12:00:00Z", "kind": "notetaker" },
    { "provider": "google-meet", "connected_at": "2026-06-20T12:00:00Z", "kind": "notetaker" },
    { "provider": "zoom", "connected_at": "2026-06-25T12:00:00Z", "kind": "notetaker" }
  ]
}

kind is publishing (LinkedIn, Buffer, Publer) or notetaker (Fireflies, Fathom, Granola, Google Meet, Zoom). Notetaker connections are created in the SparkVox app under Settings → Integrations. The API cannot connect notetaker credentials in v1.

GET/api/v1/notetaker-meetings

List Notetaker Meetings

List meetings or notes from a connected notetaker provider. Pro, Accelerate, or Scale required. Connect the provider in the app under Settings → Integrations before calling this endpoint.

Query parameters

Param	Required	Notes
provider	Yes	fireflies, fathom, granola, google-meet, or zoom
limit	No	Default 50, max 50
skip	No	Pagination offset
keyword	No	Search filter (provider-specific)

Response 200

json

{
  "meetings": [
    {
      "id": "not_1d3tmYTlCICgjy",
      "title": "Weekly sync",
      "created_at": "2026-03-01T17:01:30Z",
      "duration_seconds": 2700
    }
  ],
  "has_more": true
}

Sorted newest first. Use meeting id values when creating projects with source_type notetaker. Granola ids look like not_…; Fireflies and Fathom use their transcript ids.

Error responses

403 - Pro, Accelerate, or Scale required, or provider not connected
401 - invalid or missing API key
429 - rate limit exceeded