---
search:
  tags:
    - Suppressions
    - POST
seo:
  description: >-
    Adds up to 1000 addresses to a suppression list. key defaults to the
    workspace-wide *… Reference for the POST /suppressions endpoint in the AI
    Inbx API API.
sidebar:
  label: Create suppressions
  badge: POST
title: Create suppressions
type: openapi-operation
---
Adds up to 1000 addresses to a suppression list. `key` defaults to the workspace-wide `*` list and `scope` to `all`; a `scope` of `optional` blocks only sends marked as unsubscribable, so a marketing opt-out does not stop a password reset. Adding an address that is already listed updates the existing entry rather than duplicating it, and never narrows a wider scope. `space_id` puts the entries on a space's list, which stops that space's sends alone; without it they stop every space's.

<Operation source="api-endpoints" id="create-suppressions" />
