Skip to content

agreements_required

The tenant has not accepted the CURRENT version of every document needed by the surface. Account surfaces require MSA, Telecom Addendum, Platform Test Calls Addendum, AUP, and DPA; production surfaces additionally require the Production Services Order and scrub attestation; POST /contacts additionally requires the API Source Contact Consent Attestation; a POST /v1/subscription order with term: "three_year" additionally requires the 3-Year Commitment Addendum (gate scope commitment - ADR-0022; the recorded acceptance id lands on the provisioning operation). A test-key contact create therefore requires account + headless documents, and a live-key contact create requires account + headless + production documents. Added 2026-08-15 (ADR-0023): the second elective scope, cold_outreach. The Cold Outreach & Data Provenance Waiver is required of a tenant whose own compliance screen was admitted under it - at production activation, at staff promotion, at POST /v1/subscription, and at POST /v1/campaigns/{id}/launch and /resume, where a lapsed or superseded waiver refuses with this code naming cold_outreach_waiver alone - and separately of any campaign electing a voicemail drop, whatever that tenant's screen said. A tenant that elected no waiver condition is never asked for it. errors[] names every outstanding kind; cure with GET /v1/agreementsPOST /v1/agreements/accept. Any version or hash change re-arms the affected gate automatically.

Problem shape

Every non-2xx response is an RFC 9457 application/problem+json body. The type URI below is stable and machine-matchable, so branch on the final path segment (the code) and treat the status as redundant confirmation. See the error-handling guide.

{
  "type": "https://docs.vocapable.com/errors/agreements_required",
  "title": "…",
  "status": 403,
  "detail": "…",
  "instance": "/v1/…"
}

← Back to the error registry