Build Custom Integrations with Our API

The Supapitch REST API opens the full platform to developers who need programmatic control over campaigns, recipients, templates, analytics, and every other aspect of the outreach workflow. If your team builds internal tools, custom dashboards, automated workflows, or data pipelines that go beyond what Zapier or native integrations support, the API is the foundation you build on. It is designed to be predictable, well-documented, and developer-friendly so your engineering team can ship integrations quickly and maintain them with confidence.

Authenticate with a Bearer token passed in the Authorization header of each request. API keys can be scoped to specific permission sets — read-only for analytics consumers and reporting dashboards, write access for campaign automation, or full access for platform administration. You can generate multiple API keys with different scopes for different use cases, and each key can be revoked independently without affecting others. This granular permission model lets you follow the principle of least privilege, giving each integration only the access it needs.

Endpoints cover the entire campaign lifecycle and beyond. Create campaigns programmatically with custom settings, add recipients individually or in bulk batches of up to 10,000 per request, launch sequences with specific timing parameters, pause or resume campaigns based on external triggers, and pull detailed engagement metrics at the campaign, sequence-step, or individual-recipient level. The API also exposes endpoints for managing voice profiles, knowledge base entries, team members, and account settings, so virtually anything you can do in the Supapitch dashboard can be automated through the API.

The API follows REST conventions with JSON request and response bodies, predictable URL structures, and standard HTTP status codes. Resources use consistent naming patterns — GET for retrieval, POST for creation, PATCH for updates, and DELETE for removal. Pagination uses cursor-based tokens for efficient traversal of large result sets, and filtering parameters let you query specific subsets of data without fetching everything. Error responses include structured JSON with an error code, a human-readable message, and a documentation link, making it straightforward to diagnose issues during development.

Rate limits are generous and clearly documented in the API reference. The default rate limit is designed to support production workloads without throttling, and each API response includes rate-limit headers showing your current usage, remaining quota, and reset time. If you anticipate sustained high-volume usage — for example, a batch process that syncs thousands of recipients daily — contact Supapitch support to discuss elevated rate limits. The API also supports webhook notifications for long-running operations like bulk recipient imports, so your integration does not need to poll for completion.

Generate API keys from Supapitch's settings page in seconds. The API is compatible with any HTTP client in any programming language — teams today use it successfully from Python with the requests library, Node.js with axios or fetch, Go with net/http, Ruby, PHP, and internal scripting environments. Official SDKs for Python and Node.js are on the roadmap to simplify common patterns like pagination, error handling, and authentication. In the meantime, the API reference includes copy-paste code examples in multiple languages for every endpoint, and a Postman collection is available for interactive exploration and testing.