---
title: "Create a suppression list"
method: POST
path: "/v1/projectId/{projectId}/suppression-list"
tags: ["Suppression List"]
---

# Create a suppression list

`POST /v1/projectId/{projectId}/suppression-list`

## Request

- Base URL: `https://api.bluefox.email`
- URL: `https://api.bluefox.email/v1/projectId/{projectId}/suppression-list`
- Auth: HTTP bearer

## Path parameters

- `projectId` string, required

## Request body

- SuppressionListEntryInput
  - `email` string, required
  - `reason` string

## Response `201`

Created

- object
  - `status` integer
  - `result` SuppressionListEntry: A PROJECT-level suppression entry - this only blocks sends within this one project. It is a separate list from the account-wide bounce/complaint suppression list (populated automatically from real bounces/complaints across every project), which has no public API and can only be managed by an admin. Adding an email here does block sends to it from this project (POST /v1/projectId/{projectId}/send-transactional, /v1/projectId/{projectId}/send-triggered, campaigns, contact/subscription creation all check it).
    - `_id` string
    - `email` string
    - `reason` string
    - `createdAt` string, date-time

## Other responses

- `400`: Invalid request body or query - every violation found (missing/invalid/unexpected fields) is reported in one response, semicolon-separated, not just the first one hit.
- `403`: Missing or invalid API key
- `409`: The resource already exists

---

[API](https://skmtc.dev/bluefox/apis/bluefox-email-public-api.md) · [All operations](https://skmtc.dev/bluefox/apis/bluefox-email-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bluefox/apis/bluefox-email-public-api/revisions/fa1a0a835c7f?raw)