Skip to content

contacts.doNotCall.upload

Upload a file of numbers.

Reference

POST/api/v1/do-not-call/upload

Auth
API key in X-API-Key
Content
multipart/form-data
Returns
200 · AddNumbersResponse

Bulk upload from a CSV. Every cell of every row is considered, not just a named column. The files people actually have are exports with the number in whichever column that CRM chose, often with no header at all, and rejecting them for having the wrong shape means the list does not get uploaded — which is a compliance outcome, not a UX one. Anything that does not normalise to a phone number is reported back rather than silently ignored.

Arguments

ArgumentInTypeRequiredDescription
filebodystringrequired

Example request

curl -X POST "https://api.decibyl.ai/api/v1/do-not-call/upload" \
  -H "X-API-Key: dcb_your_key" \
  -F "file=@file"

Response

{
  "added": 1,
  "already_listed": 1,
  "rejected": [
    "string"
  ]
}

Errors

StatusWhen
404Not found
422Validation Error