PPactDocs
Developers

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.

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 + offset and return { items, total, limit, offset }; high-volume streams use cursors. See pagination.
  • Rate limits — every response carries X-RateLimit-* headers; honor Retry-After on 429.

Cookbook recipes