---
title: "Add User to Suppression List"
method: POST
path: "/{WSID}/suppressions"
tags: ["Suppression List"]
---

# Add User to Suppression List

`POST /{WSID}/suppressions`

Add a user to the suppression list for a given channel.

**Note:** If both `distinct_id` and `destination` are provided, `distinct_id` takes precedence, and `destination` is ignored.

## Path parameters

- `WSID` string, required

## Request body

- union
  - object
    - `distinct_id` string, required — Unique identifier (used as an alternative to destination)
    - `channel` string, required — Communication channel (e.g., sms, whatsapp, email)
    - `description` string — Reason or tag for suppression (e.g., "DND", "Testing").
  - object
    - `destination` string, required — Phone number or email of the suppressed user
    - `channel` string, required — Communication channel (e.g., sms, whatsapp, email)
    - `description` string — Reason or tag for suppression (e.g., "DND", "Testing").

## Response `200`

Suppression list updated.

- object
  - `status` string
  - `_message` string

## Other responses

- `400` — Destination is invalid
- `401` — API Key or Workspace ID is invalid. User is unauthorised.

---

[API](https://skmtc.net/fynoio/apis/fyno-rest-api.md) · [All operations](https://skmtc.net/fynoio/apis/fyno-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fynoio/fyno-rest-api/revisions/021088e9cb30/schema)