---
title: "Add blocklist entries"
method: POST
path: "/blocklist"
tags: ["Blocklist"]
---

# Add blocklist entries

`POST /blocklist`

## Request

- Base URL: `https://api.emailchaser.com/r`
- URL: `https://api.emailchaser.com/r/blocklist`
- Auth: HTTP bearer

Adds up to 1000 suppression entries in one call. Each value is either a full email address (contains "@") or a bare domain. Existing entries and invalid values are skipped, so the call is safe to retry and suited to carrying over a suppression list from another sending platform. `scope` defaults to "workspace", which suppresses for the calling key's workspace only; "global" suppresses across every workspace on the account and requires a main workspace's key.

## Request body

- ModelsBlocklistAddRequest
  - `scope` 'workspace' | 'global': Scope is "workspace" (default) or "global". A global entry suppresses across every workspace on the account and can only be written with a main workspace's API key.
  - `values` string[], required: Values holds the email addresses and/or domains to block, up to 1000 per request.

## Response `200`

OK

- ModelsBlocklistAddResponse
  - `created` integer: Created is the number of new suppression entries written.
  - `scope` 'workspace' | 'global': Scope is the list the entries were written to.
  - `skipped` integer: Skipped is the number of values ignored because they already existed or failed validation.

## Other responses

- `400`: Invalid request body
- `401`: Unauthorized - invalid or missing API key
- `403`: Only a main workspace's key may write the account-wide blocklist
- `500`: Failed to add entries

---

[API](https://skmtc.dev/emailchaser/apis/emailchaser-api.md) · [All operations](https://skmtc.dev/emailchaser/apis/emailchaser-api/llms.txt) · [OpenAPI document](https://skmtc.dev/emailchaser/apis/emailchaser-api/revisions/8b114990abb7?raw)