---
title: "POST /public/v1/warmlist/{workspaceId}/prospects/dnc"
method: POST
path: "/public/v1/warmlist/{workspaceId}/prospects/dnc"
tags: ["Warm List"]
---

# POST /public/v1/warmlist/{workspaceId}/prospects/dnc

`POST /public/v1/warmlist/{workspaceId}/prospects/dnc`

Add warmlist prospects to the Do Not Contact list by ID or filter.

## Path parameters

- `workspaceId` string, required

## Request body

- object
  - `prospectIds` string[] — Specific prospect IDs.
  - `selectAll` boolean — Target all prospects matching the filters below.
  - `engagementType` string — Required when selectAll is true.
  - `monitoredProfileId` string — Only for POST_ENGAGEMENTS.
  - `postId` string — Only for POST_ENGAGEMENTS.
  - `postEngagementType` string — COMMENT or REACTION.
  - `icpFit` string[]
  - `profilePrivacy` string — "open" or "closed".

## Response `200`

Default Response

- object
  - `statusCode` number
  - `status` boolean
  - `message` string
  - `data` object
    - `queued` number

## Other responses

- `400` — Default Response
- `401` — Default Response
- `403` — Default Response
- `429` — Default Response
- `500` — Default Response

---

[API](https://skmtc.net/joinvalley/apis/valley-public-api.md) · [All operations](https://skmtc.net/joinvalley/apis/valley-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/joinvalley/valley-public-api/revisions/1d888a894943/schema)