---
title: "Add Suppression"
full: true
_openapi:
  method: POST
  toc: []
  structuredData:
    headings: []
    contents:
      - content: "Adds an email address to the organization's suppression list with a reason. Creates the contact if it does not exist. Sends to the address are rejected until it is removed."
_apiData:
  document: "https://reloop.sh/api/contacts/openapi/json"
  operationData: [{"path":"/api/contacts/v1/suppressions","method":"post"}]
  parameterList: [{"name":"email","type":"string","required":true,"description":"Email address to stop sending to","location":"body","maxLength":255,"pattern":"^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$","example":"john.doe@example.com"},{"name":"reason","type":"string","required":true,"description":"Why this address is being suppressed","location":"body","maxLength":500,"pattern":"\\S","example":"Asked to never be contacted again"}]
  responseMap: {"200":{"description":"Response for status 200","schema":{"object":"suppression","contactId":"example_contactId","email":"john.doe@example.com","suppressionSource":"manual","suppressionNote":"example_suppressionNote","suppressedAt":"2026-03-23T10:00:00.000Z"}},"400":{"description":"Response for status 400","schema":{"message":"Invalid email format","why":"A contact with this email already exists in your organization.","fix":"Use a different email address or update the existing contact instead."}},"403":{"description":"Response for status 403","schema":{"message":"Unauthorized access","why":"A contact with this email already exists in your organization.","fix":"Use a different email address or update the existing contact instead."}},"409":{"description":"Response for status 409","schema":{"message":"Already suppressed","why":"A contact with this email already exists in your organization.","fix":"Use a different email address or update the existing contact instead."}}}
  codeSamples: []
---
> For the complete documentation index, see [llms-docs.txt](/llms-docs.txt) or the site index [llms.txt](/llms.txt). Full docs corpus: [llms-full-docs.txt](/llms-full-docs.txt). Prefer markdown URLs (append `.md`) for agent consumption. Product skill: [skill.md](/skill.md).


{/* This file was generated by the OpenAPI doc generator. Do not edit this file directly. Run `bun run generate:api-docs` to regenerate. */}

<APIPage />