leads

Permanently suppress an email address account-wide.

The manual/free-text "stop emailing me" path for opt-outs the strict typed-unsubscribe matcher misses. Cancels every pending send and marks every campaign-lead row for this email suppressed. There is no un-suppress endpoint.

post/leads/suppress

Request

  • Base URL: https://api.coldrig.dev
  • URL: https://api.coldrig.dev/leads/suppress
  • Auth: HTTP bearer

Request body

emailstring email required
reason'manual'

Pinned to "manual" — the only value an external caller can claim. bounce/soft_bounce/complaint/unsubscribe are exclusively system-derived elsewhere.

notestring

Accepted for schema symmetry; not persisted (suppressions carries no note column).

Response

Suppressed.

suppressedtrue required
alreadySuppressedboolean required

Changes

No recorded changes to this operation across all 2 revisions of this API.