---
title: "Create DND"
method: POST
path: "/suppressions/{dnd_type}"
tags: ["suppression"]
---

# Create DND

`POST /suppressions/{dnd_type}`

## Request

- Base URL: `https://cpaas.zoho.com/v1.1`
- URL: `https://cpaas.zoho.com/v1.1/suppressions/{dnd_type}`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://accounts.zoho.com/oauth/v2/auth`
    - Token URL: `https://accounts.zoho.com/oauth/v2/token` scopes: `Zeptomail.Suppressions.CREATE`
  - OAuth 2
    - Authorization code: `https://accounts.zoho.com/oauth/v2/auth`
    - Token URL: `https://accounts.zoho.com/oauth/v2/token` scopes: `Zeptomail.Suppressions.ALL`

Add a new suppression (DND) entry. The suppression entry can be an email address or a domain. Once added, emails will not be delivered to the suppressed address or domain.

## Path parameters

- `dnd_type` 'email' | 'domain', required

## Request body

- object
  - `values` string[], required: Array of email addresses or domains to suppress.
  - `action` 'reject' | 'suppress' | 'suppress_tracking', required: Suppression action. Allowed values: `reject`, `suppress`, `suppress_tracking`.
  - `mailagent_keys` string[]: Array of Mail Agent keys the suppression applies to.
  - `description` string: Description or reason for adding the suppression entry.

## Response `200`

Suppression entry created successfully.

- object
  - `message` string
  - `status` string

## Other responses

- `400`: Bad Request

---

[API](https://skmtc.dev/zoho/apis/zoho-cpaas.md) - [All operations](https://skmtc.dev/zoho/apis/zoho-cpaas/llms.txt) - [OpenAPI document](https://skmtc.dev/zoho/apis/zoho-cpaas/revisions/f0858a38e8b0?raw)
