---
title: "Ingest New"
method: POST
path: "/{WSID}/suppressions/ingest"
tags: ["Suppression List"]
---

# Ingest New

`POST /{WSID}/suppressions/ingest`

## Request

- Base URL: `https://api.fyno.io/v1`
- URL: `https://api.fyno.io/v1/{WSID}/suppressions/ingest`
- Auth: HTTP bearer

Bulk add users to the suppression list. Use this endpoint to suppress multiple destinations (e.g. email addresses or phone numbers) on a given channel in a single request, instead of calling [Add User to Suppression List](./add-user-to-suppression-list) once per user.

Each item in the `batch` array is one user to suppress. The batch is processed asynchronously, and a `202` response means it has been accepted for processing.

Example request:

`POST {{API_URL}}/v1/{{WSID}}/suppressions/ingest`

## Path parameters

- `WSID` string, required

## Headers

- `version` 'live' | 'test', required

## Request body

- IngestSuppressionList
  - `batch` object[], required: Enter an array of users to add to the suppression list. Each item suppresses one destination on the specified channel, for example `{"destination": "abcde@fghi.com", "channel": "email"}`.
    - `destination` string, required: The recipient identifier to suppress, for example `abcde@fghi.com` for the `email` channel or `+49XXXXXXXXX` for the `sms` channel. Enter a phone number with the country code.
    - `channel` 'email' | 'sms', required: The notification channel to suppress, for example `email` or `sms`.

## Response `202`

The batch of users has been accepted and will be added to the suppression list asynchronously.

- object
  - `status` string, required

## Other responses

- `401`: API Key or Workspace ID is invalid. User is unauthorised.

## Changes

- **2026-09-14** `63b60a94cdbb`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/fynoio/apis/fyno-rest-api/changes/:WSID/suppressions/ingest/post.md)

---

[API](https://skmtc.dev/fynoio/apis/fyno-rest-api.md) - [All operations](https://skmtc.dev/fynoio/apis/fyno-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fynoio/apis/fyno-rest-api/revisions/4007bf338a0b?raw)
