---
title: "Add up to 5,000 emails to the workspace do-not-contact list. campaign:write required. No domains or loosening. DNC_IMPORT_ENABLED defaults to NO; also requires list release. dry_run writes nothing."
method: POST
path: "/v1/do_not_contact"
tags: ["Guard"]
---

# Add up to 5,000 emails to the workspace do-not-contact list. campaign:write required. No domains or loosening. DNC_IMPORT_ENABLED defaults to NO; also requires list release. dry_run writes nothing.

`POST /v1/do_not_contact`

## Request

- Base URL: `https://api.layrcake.dev`
- URL: `https://api.layrcake.dev/v1/do_not_contact`
- Auth: HTTP bearer

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `emails` string[], required
  - `note` string
  - `dry_run` boolean

## Response `200`

Import counts; dry_run counts are advisory and queue nothing

- object
  - `result` object, required
    - `import_id` string, uuid, nullable, required
    - `added` integer, required
    - `already_listed` integer, required
    - `strengthened` integer, required
    - `invalid` integer, required
    - `free_mail_refused` integer, required
    - `queued_for_removal` integer, required
    - `replayed` boolean, required
    - `dry_run` boolean, required

## Other responses

- `400`: Invalid request, including domains or more than 5,000 emails
- `403`: Missing campaign:write scope
- `404`: Import or list release disabled
- `409`: Idempotency-Key reused with different parameters
- `429`: Shared key rate limit exceeded

---

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