> For the complete documentation index, see [llms.txt](https://docs.bird.com/api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bird.com/api/contacts-api/api-reference/manage-contact-suppressions.md).

# Manage contact suppressions

## Suppressions

A suppression in the Bird Contacts API is a mechanism that ensures messages are not sent to customers who have opted out of specific communication types, such as marketing or transactional messages. It operates by associating a contact's identifier, like an email address, with suppression preferences, specifying which types of communication should be avoided and why.

### API Reference Guide <a href="#api-reference-guide" id="api-reference-guide"></a>

1. [Upsert a workspace-platform-level suppression](/api/contacts-api/api-reference/manage-contact-suppressions/upsert-a-workspace-platform-level-suppression.md)
2. [Get a suppression](/api/contacts-api/api-reference/manage-contact-suppressions/get-a-suppression.md)
3. [List workspace-platform-level suppressions](/api/contacts-api/api-reference/manage-contact-suppressions/list-workspace-platform-level-suppressions.md)