API reference
Add a recipient to this account's suppression list
Source: OpenAPI (openapi/openapi.yaml).
curl -X POST "https://api.sendtier.example/suppressions" \ -H "Authorization: Bearer st_live_REPLACE_ME" \ -H "Content-Type: application/json" \ -d '{ "email": "user@example.com" }'{ "email": "string", "reason": "bounce", "created_at": "2019-08-24T14:15:22Z", "source": "api"}POST
Requires a full-scope key. Emails are normalized to lower case. Existing entries are returned unchanged.
header
AuthorizationBearer <token>API key: st_live_... or st_test_...
Idempotency-Key?stringRepeated POST with the same key within 24 h returns the first response.
Length
length <= 255application/json- body
email*stringFormat
emailreason?"manual"Default
"manual"Value in
"manual"The existing suppression.
application/json- response
email*stringreason*stringValue in
"bounce""complaint""manual"created_at*stringFormat
date-timesource?stringManual entries come from the API; bounce and complaint entries come from the provider.
Value in
"api""provider"