Developers
Build on Pact — REST API, OAuth, webhooks, SDKs, and integration recipes.
Everything you need to build on Pact. The API is REST over HTTPS, returns JSON, and authenticates with a bearer key or an OAuth token. The base URL is https://app.pact.place.
Every endpoint, parameter, and response — try calls in the browser.
Get an API keyGenerate a scoped key from Settings and make your first call.
Your first API callList accounts with curl, TypeScript, and Python.
OAuth in 5 minutesConnect a third-party app on behalf of a workspace.
WebhooksSubscribe to events and verify signed deliveries.
SDK code examplesCopy-paste snippets for the most-used endpoints.
Integration cookbookEnd-to-end recipes: migrate, sync, back up, embed.
Rate limits & quotasPer-tier budgets, headers, and backoff.
OAuth & API scopesEvery scope and recommended sets per use case.
MCP SDKsCall Pact from an AI agent, or publish your own MCP tools — TypeScript & Python.
Core concepts
- Authentication — pass
Authorization: Bearer <key-or-token>. Keys (pact_live_…) are for your own backend; OAuth is for apps acting on behalf of another workspace. - Identifiers — records are addressed by
public_id(a UUID). Never build URLs from an internal integer id. - Pagination — list endpoints use
limit+offsetand return{ items, total, limit, offset }; high-volume streams use cursors. See pagination. - Rate limits — every response carries
X-RateLimit-*headers; honorRetry-Afteron429.
Cookbook recipes
Export, map fields, and import in an afternoon.
Sync deals with project ticketsCreate a ticket on every won deal via webhooks.
Nightly backup to S3Snapshot every record to storage you control.
Custom dashboardChart pipeline data with the API + Recharts.
Embed formsDrop a hosted form into any marketing page.