Skip to main content
POST
Add to Do-Not-Contact
Use this to push opt-outs from your other channels (WhatsApp, email, forms) into Tuco. Every message is checked against this list before it is sent. A successful add fires the dnc.added webhook.

Authentication

Example

Success response (200)

Errors

To add many contacts at once, use Bulk add. Removing a contact from the list is done in the dashboard only.

Authorizations

Authorization
string
header
required

Workspace API key: Authorization: Bearer tuco_xxxxxxxxxxxxx

Body

application/json
phone
string

Phone number in any common format; stored as E.164. Either phone or email is required.

Example:

"555-010-0778"

email
string<email>

Email address; stored lower case

reason
string
default:manual
Example:

"whatsapp-opt-out"

Response

Added

ok
boolean
required
id
string
required