Create a disclosure config

const url = 'https://saperly.com/api/v1/disclosures';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"message":"This call may be recorded and uses AI to assist with customer service."}'
};
try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

{
  "disclosure": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "message": "This call may be recorded and uses AI to assist with customer service.",
    "audio_url": "https://saperly.com/audio/disclosures/recording_notice_en_us.mp3",
    "language": "en-US",
    "jurisdiction": "US_TCPA",
    "is_default": true,
    "created_at": "2024-01-15T09:30:00Z"
  }
}

Creates a new disclosure configuration. Disclosures are played at the start of calls to comply with recording/AI notification regulations.

Authentication

AuthorizationBearer

Send as Authorization: Bearer <your-key>. Obtain keys from the portal — prefix sk_live_ for production, sk_test_ for sandbox.

Request

This endpoint expects an object.

messagestringRequired>=1 character

Disclosure message text

languagestringOptional

Language code

Response

Disclosure created

disclosureobject

Errors

401

Unauthorized Error

422

Unprocessable Entity Error

429

Too Many Requests Error