SparkVox

Developer API

REST API and webhooks for programmatic integrations.

The SparkVox Developer API (v1) lets you submit recording URLs, transcripts, or cloud files from connected Google Drive, Dropbox, or OneDrive, receive webhooks when posts are ready, and manage drafts programmatically - including publishing to LinkedIn and generating or uploading post images. Same processing-time billing and the same curation and generation pipeline as the web app (moment scoring, best-of-two hook ranking, voice profile, distinctiveness on Awareness/Authority drafts).

  • API reference: sparkvox.io/docs/api
  • Base URL: app.sparkvox.io/api/v1
  • YouTube metadata (no key): GET app.sparkvox.io/api/url-metadata?url=...
  • API keys: Settings > Developer in the app
  • Connected tools: GET/api/v1/integrations before scheduling posts
  • Full docs: sparkvox.io/docs/api
  • Quickstart: sparkvox.io/docs/api/getting-started#quickstart
  • Guides: data model, projects, posts, media under /docs/api/guides
  • Changelog: sparkvox.io/docs/api/getting-started#changelog
  • Overview: sparkvox.io/developers
  • Cloud project import (MP3, TXT, SRT, and Google Docs on Drive in web app; MP3, SRT, and Google Docs on google-drive via API): POST/api/v1/projects with source_type cloud (Pro, Google Drive, Dropbox, or OneDrive connected). Providers: google-drive, dropbox, onedrive. Web app also offers Import from cloud tab with each provider's file picker. Cloud OAuth and picker endpoints are session-only - not API key auth.
  • Notetaker project import (Pro, Accelerate, or Scale): POST/api/v1/projects with source_type notetaker and provider fireflies, fathom, granola, google-meet, or zoom. List meetings with GET/api/v1/notetaker-meetings. Connect the provider in Settings → Integrations first.
  • Feature requests (Pro only) and bug reports (any signed-in user) are web-app only - there is no public API for submitting feedback or triaging requests.
  • Rate limits (per API key, rolling 24h): 2,000 read requests (GET) and 100 write requests (POST/PATCH/DELETE) per day. Check headroom with GET/api/v1/account.

In the app, open Settings → Developer (Pro required) to create and revoke API keys, register webhook URLs, expand a webhook to view recent delivery attempts (HTTP status and errors), and send a test ping. Usage columns show read and write counts separately. The same keys and webhooks work with the REST endpoints at sparkvox.io/docs/api.