---
title: "Add entries to Do Not Contact list"
method: POST
path: "/v3/user-api/do-not-contacts"
tags: ["Do Not Contact"]
---

# Add entries to Do Not Contact list

`POST /v3/user-api/do-not-contacts`

## Request

- Base URL: `https://api.nureply.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.nureply.com/v3/user-api/do-not-contacts`
- Auth: none declared. Required headers: `x-personal-api-key`

Add one or multiple email addresses and domains to your Do Not Contact (suppression) list. Supports 1-2000 entries per request. Duplicates are skipped automatically.

## Headers

- `x-personal-api-key` string, required

## Request body

- CreateDNCBatchDto
  - `entries` DNCEntry[], required: Array of entries to add (max 2000)
    - `value` string, required: Email address or domain to block
    - `type` 'email' | 'domain', required: Type of entry
    - `reason` 'unsubscribe' | 'bounce' | 'spam_complaint' | 'manual' | 'invalid' | 'other', required: Reason for blocking
    - `notes` string: Optional notes (max 500 characters)

## Response `201`

- AddDNCEntriesResponseDto
  - `message` string, required
  - `data` DNCBatchResultDataDto, required
    - `added` number, required
    - `duplicates` number, required
    - `invalid` number, required
    - `summary` DNCBatchSummaryDto, required
      - `totalProvided` number, required
      - `added` number, required
      - `duplicates` number, required
      - `invalid` number, required
    - `addedEntries` DNCEntryDto[], required
      - `value` string, required
      - `type` 'email' | 'domain', required
      - `reason` 'unsubscribe' | 'bounce' | 'complaint' | 'manual', required
      - `_id` string
      - `createdAt` string
    - `duplicateValues` string[], required
    - `invalidValues` string[], required

## Other responses

- `400`
- `401`

---

[API](https://skmtc.dev/nureply/apis/nureply-api.md) - [All operations](https://skmtc.dev/nureply/apis/nureply-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nureply/apis/nureply-api/revisions/a754b8b5eb0a?raw)