Skip to content
BookifyCall
Developer docs: Do not call

Do not call

Numbers that must never be called (outbound safety).

List numbers that must never be calledLink to List numbers that must never be called

GET/do-not-call

Newest first. Every outbound and scheduled call to a listed number is refused (CALL_045). Organization-wide: not for agent-bound keys. 404 FLAG_001 while outbound safety is off for the organization.

Scope
calls:read
Not found
404 FLAG_001

Query parameters

pagenumber
Default: 1
limitnumber
Default: 20 · Max 100
searchstring
Digits of the number, or words of the reason
curl "https://bookifycall.com/api/v1/external/do-not-call" \
  -H "X-API-Key: $BOOKIFYCALL_API_KEY"
Example response · 200
{
  "success": true,
  "data": [
    {
      "id": "00000000-0000-4000-8000-000000000010",
      "phone": "+15551230009",
      "source": "api",
      "reason": "Asked not to be called again",
      "callId": null,
      "createdAt": "2026-10-16T12:00:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 1,
    "pages": 1
  }
}

Add a number to the do-not-call listLink to Add a number to the do-not-call list

POST/do-not-call

Idempotent: a number already listed returns its existing entry. Pending scheduled calls to the number are cancelled. A number with an extension is 400 DNC_002. Organization-wide: not for agent-bound keys (403 AUTH_006). 404 FLAG_001 while outbound safety is off.

Scope
calls:write
Not found
404 FLAG_001

Body (JSON)

phoneNumberstringrequired
E.164
reasonstring
Up to 500 characters
curl -X POST "https://bookifycall.com/api/v1/external/do-not-call" \
  -H "X-API-Key: $BOOKIFYCALL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"phoneNumber":"+15551230009","reason":"Asked not to be called again"}'
Example response · 201
{
  "success": true,
  "data": {
    "id": "00000000-0000-4000-8000-000000000010",
    "phone": "+15551230009",
    "source": "api",
    "reason": "Asked not to be called again",
    "callId": null,
    "createdAt": "2026-10-16T12:00:00.000Z"
  }
}

Remove a number from the do-not-call listLink to Remove a number from the do-not-call list

DELETE/do-not-call/{id}

Only when the person has agreed to be called again. Organization-wide: not for agent-bound keys (403 AUTH_006). 404 FLAG_001 while outbound safety is off.

Scope
calls:write
Not found
404 DNC_001

Path parameters

idstringrequired
curl -X DELETE "https://bookifycall.com/api/v1/external/do-not-call/00000000-0000-4000-8000-000000000010" \
  -H "X-API-Key: $BOOKIFYCALL_API_KEY"
Example response · 200
{
  "success": true,
  "data": {
    "id": "00000000-0000-4000-8000-000000000010"
  }
}
Next: Leads