Mass approve or unapprove DNC

Approve or unapprove many Do Not Call (DNC) entries in a single request, and optionally create any that do not exist yet.

When to use. Update the approval status of many numbers at once. For a single number, use POST /dnc to add one, or the {id}/approve and {id}/unapprove endpoints to change one entry.

Request body.

  • dnc (array, required): the entries to process. Each item has:
    • phone (string, required): the phone number.
    • approved (integer, required): target approval status, 0 for unapproved or 1 for approved.
    • country_iso (string): the two-letter country code (for example US) used to normalize the number.
    • permanent (integer): whether the entry is permanent, 0 for no or 1 for yes.
  • create_missing (boolean): set to true to create entries that are not found. A number is created only when it can be normalized.

Returns. { "dnc": [ ... ] } with one processed entry per input item. Returns an error if the dnc list is empty, or an item is missing its approved value.

Example. { "create_missing": true, "dnc": [ { "phone": "12125551234", "country_iso": "US", "approved": 1 } ] }

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Request body for mass approving/unapproving (and optionally creating) DNC entries.

boolean

Set to true to create DNC entries that do not yet exist.

dnc
array of objects
required

Array of DNC entries to process.

dnc*
Responses

Language
Credentials
:
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json