Add a suppression

Block one email, domain, LinkedIn profile or company name, and stop pending steps for the contact an email matches. Suppression survives contact deletion and every retention purge. An existing entry answers 409, which is the state you wanted.

POSThttps://app.trygtm.com/api/v1/suppressions

Scope: write
MCP tool: add_suppression

Headers

Idempotency-Keystringoptional: A key unique to this write, up to 255 characters. A retry carrying the same key returns the first response instead of running again. Kept for 24 hours.

Body

targetstringrequired: What kind of identity the value is.emaildomainlinkedin_urlcompany_name
valuestringrequired: The address, domain, profile URL or company name.
reasonstringoptionaldefault: manual: Why it is blocked.unsubscribebouncecomplaintmanualcompetitorexisting_customerlegal_request
notestringoptional: Free text kept beside the row.

Request

curl -X POST https://app.trygtm.com/api/v1/suppressions \
  -H "Authorization: Bearer $TRYGTM_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "target": "email",
    "value": "dana@northbeam.example"
  }'

Response

{
  "data": {
    "id": "c3d4e5f6-a7b8-4c9d-8e0f-1a2b3c4d5e6f",
    "scope": "workspace",
    "email": "dana@northbeam.example",
    "domain": null,
    "company_name": null,
    "linkedin_url": null,
    "reason": "manual",
    "note": null,
    "created_at": "2026-09-18T10:20:00.000Z",
    "stopped_queued_steps": 2
  }
}