DNC

Add to DNC

Add one or more email addresses or domains to the Do Not Contact list. Entries that already exist are skipped (not duplicated). Emails are lowercased automatically.

curl -X POST "https://api.sendkit.ai/v1/dnc" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{
  "entries": [
    {
      "email": "unsubscribed@example.com",
      "reason": "manual"
    }
  ]
}'

import requests
import json

url = "https://api.sendkit.ai/v1/dnc"
headers = {
  "Content-Type": "application/json",
  "X-Api-Key": "YOUR_API_KEY",
  "Authorization": "Bearer YOUR_API_TOKEN"
}
data = {
  "entries": [
    {
      "email": "unsubscribed@example.com",
      "reason": "manual"
    }
  ]
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

const response = await fetch("https://api.sendkit.ai/v1/dnc", {
  method: "POST",
  headers: {
  "Content-Type": "application/json",
  "X-Api-Key": "YOUR_API_KEY",
  "Authorization": "Bearer YOUR_API_TOKEN"
},
  body: JSON.stringify({
  "entries": [
    {
      "email": "unsubscribed@example.com",
      "reason": "manual"
    }
  ]
})
});

const data = await response.json();
console.log(data);

package main

import (
    "fmt"
    "net/http"
    "bytes"
    "encoding/json"
)

func main() {
    data := []byte(`{
  "entries": [
    {
      "email": "unsubscribed@example.com",
      "reason": "manual"
    }
  ]
}`)

    req, err := http.NewRequest("POST", "https://api.sendkit.ai/v1/dnc", bytes.NewBuffer(data))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("X-Api-Key", "YOUR_API_KEY")
    req.Header.Set("Authorization", "Bearer YOUR_API_TOKEN")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    fmt.Println("Response Status:", resp.Status)
}

require 'net/http'
require 'json'

uri = URI('https://api.sendkit.ai/v1/dnc')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request['X-Api-Key'] = 'YOUR_API_KEY'
request['Authorization'] = 'Bearer YOUR_API_TOKEN'
request.body = '{
  "entries": [
    {
      "email": "unsubscribed@example.com",
      "reason": "manual"
    }
  ]
}'

response = http.request(request)
puts response.body

{
  "success": true,
  "data": {
    "added": 2,
    "skipped": 1
  }
}

POST

/v1/dnc

POST

API Key (header: X-Api-Key)

X-Api-Keystring

Required

Platform API key (sk_user_...) or Workspace API key (sk_...)

Bearer Token

Bearer Tokenstring

Required

API key as Bearer token

Content-Typestring

Required

The media type of the request body

Options: application/json

entriesarray

Required

List of DNC entries to add

Request Preview

Response

Response will appear here after sending the request

Authentication

header

X-Api-Keystring

Required

API Key for authentication. Platform API key (sk_user_...) or Workspace API key (sk_...)

header

Authorizationstring

Required

Bearer token. API key as Bearer token

Body

application/json

entriesarray

Required

List of DNC entries to add

Responses

Was this page helpful?

Last updated today

Built with Documentation.AI

curl -X POST "https://api.sendkit.ai/v1/dnc" \ -H "Content-Type: application/json" \ -H "X-Api-Key: YOUR_API_KEY" \ -H "Authorization: Bearer YOUR_API_TOKEN" \ -d '{ "entries": [ { "email": "unsubscribed@example.com", "reason": "manual" } ] }'