For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
my.pivotal.appGet an API key
LogoLogo
my.pivotal.appGet an API key

Pivotal developer documentation

|Open in Claude|Open in ChatGPT
Was this page helpful?
Edit this page
Built with
  • For clean Markdown of any page, append .md to the URL.
  • Pull the whole site as a single context: /llms-full.txt. Short index: /llms.txt.
  • Every page has Open in Claude / Open in ChatGPT in the action bar.
  • OpenAPI spec lives at my.pivotal.app/api/v1/openapi.json.

Pivotal developer documentation

The Pivotal API and webhooks expose the same primitives the Pivotal app uses internally: customers, contacts, onboardings, and tasks. Use them to mirror customers from your CRM, attach contacts as you collect them, drive onboardings through their phases, and stream events into your stack.


SURFACES
REST API

Bearer auth, JSON in, JSON out. Every endpoint mirrors what the app does internally. Cursor pagination, idempotency keys, soft deletes, ISO 8601 dates, snake_case everywhere.

Webhooks

Subscribe to events, pick the types you care about, receive signed payloads. Delivered via Svix with 24h exponential backoff and a replay button in the dashboard.

Product docs

End-user help for the Pivotal app. Setup, customers, onboardings, integrations, Workbench, and Ask Pi. The non-developer-facing surface.


DATA MODEL

Three first-class objects. Tasks live under onboardings.

Customercentral recordContactsN per customerOnboardingsN per customerTasksN per onboarding

DEVELOPER TOOLS
TypeScript SDK

npm i @pivotal/api. Strict types from the OpenAPI spec.

Python SDK

pip install pivotal. Same shape as the TS client.

OpenAPI spec

Generate a client in any language from the live spec.

Idempotency keys

Replay-safe POSTs. Drop a key on the header, retry without dupes.

Test mode

pivotal_test_ keys write to the same workspace, isolated by a flag.

LLM-friendly docs

Single-file context, .md URL suffix, and Open-in-Claude links.


Get started

Create an API key

Live (pivotal_…) or test (pivotal_test_…). Scoped to one workspace.

Quickstart

Key to customer to contact to onboarding in three minutes.

API reference

Every endpoint, every shape. Run requests from inside the docs.

Set up webhooks

Subscribe an endpoint, pick events, verify signatures, replay failures.

Email help@pivotal.app with the request you ran, the response body, and the response headers. For something time-sensitive, include “P0” in the subject.