---
title: "to unsubscribe prospects"
method: POST
path: "/v1/prospects/unsubscribe"
tags: ["prospects"]
---

# to unsubscribe prospects

`POST /v1/prospects/unsubscribe`

## Request

- Base URL: `https://developer.saleshandy.com` (the document declares no server; this is the origin it was published from)
- URL: `https://developer.saleshandy.com/v1/prospects/unsubscribe`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/saleshandy/apis/develop-with-saleshandy/docs/v1/prospects/unsubscribe/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- ProspectsUnsubscribeDto
  - `prospectIds` string[], required: array of prospect ids to unsubscribe

## Response `200`

Prospect(s) unsubscribed successfully<br><br>

## Other responses

- `400`: 1001: Invalid token<br><br>
- `403`: 4003: You don't have required permissions to perform this task<br><br>
- `500`: 5001: Internal server error, please try again later<br><br>

## Changes

- **2026-10-23** `e7a29c931aa7`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/saleshandy/apis/develop-with-saleshandy/changes/v1/prospects/unsubscribe/post.md)

---

[API](https://skmtc.dev/saleshandy/apis/develop-with-saleshandy.md) - [All operations](https://skmtc.dev/saleshandy/apis/develop-with-saleshandy/llms.txt) - [OpenAPI document](https://skmtc.dev/saleshandy/apis/develop-with-saleshandy/revisions/e7a29c931aa7?raw)