Introduction - Compensable

The Compensable API is the programmatic surface of the same control plane that runs your intake agent. Today it covers three things: creating dynamic number insertion (DNI) sessions for inbound tracking, posting buyer dispositions back onto a call, and executing an outbound cadence touch. It’s built for firms that run their own dialers or websites and want to plug into Compensable’s tracking and outreach without going through the dashboard.

What you can do today

Create a DNI session — POST /dni/session. Hand a website visitor a tracking number tied to a campaign, so an inbound call from that visitor can be attributed back to the traffic source that produced it.
Post a buyer report — POST /dni/campaigns/{campaign_code}/buyer-report. Record a buyer’s disposition (success or rejected) against a call so lead-buying outcomes land back in your reporting.
Execute an outbound touch — POST /tracking/campaigns/{campaign_code}/outbound. Trigger one governed outbound call, SMS, or voicemail drop under a campaign’s consent, quiet-hours, and frequency rules.

Full parameters and response shapes for each endpoint are in the Endpoints section of this reference, generated directly from the API’s schema.

Base URL

Every request goes to:

https://api.compensable.live

There’s no separate sandbox host today; requests run against your live workspace.

API access is enabled per workspace, alongside your key. If every request returns a 403 with tracking_disabled, access isn’t switched on for your organization yet — contact support. See Authentication.

Requests and responses

Every request and response body is JSON. Send Content-Type: application/json on any request with a body, and expect application/json back, including on error responses.

A small, growing surface

This API is intentionally small right now. It covers number tracking, buyer reporting, and cadence execution because those are the integration points firms have asked for first. If you need an endpoint you don’t see here — reading call data, managing campaigns, or something else — contact support and describe what you’re building. More of the platform is coming to this surface over time.

Try it

Here’s a minimal call to create a DNI session, using only the required fields:

curl https://api.compensable.live/dni/session \
  -X POST \
  -H "Authorization: Bearer cmp_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "campaign_code": "9k2",
    "visitor_id": "visitor-abc123"
  }'

A successful call returns 201 with the tracking number to show the visitor:

{
  "tracking_number": "+18005551234",
  "dni_session_id": "dni_a1b2c3d4e5f60789",
  "expires_at": "2026-07-21T18:00:00Z"
}

See Authentication for how to get and use an API key.

​What you can do today

​Base URL

​Requests and responses

​A small, growing surface

​Try it

What you can do today

Base URL

Requests and responses

A small, growing surface

Try it