Put suppression entry

Idempotent — re-PUTting an existing email overwrites the reason + details with the new values.

PUT

/api/v1/partner/email/suppression/:email

Request body

{
  "reason": "MANUAL",
  "details": "GDPR erasure request 2026-05-03 ticket #1024"
}

Field	Type	Required	Notes
`reason`	string	no	`MANUAL` (default) / `BOUNCE` / `COMPLAINT` / `UNSUBSCRIBE`
`details`	string	no	Free-text note. Surfaced in audit + UI

Response

{
  "success": true,
  "email": "[email protected]",
  "reason": "MANUAL"
}

Use cases

Honoring opt-out clicks in your app — when a user clicks unsubscribe in your preferences page, push them here so you stop sending across all your sending integrations
GDPR / DPDP erasure — adds the address with a MANUAL reason + a note referencing the ticket
Pre-emptive blocklist — known-bad addresses you never want to email, regardless of the source list

cURL

curl -X PUT \
  https://api.splashifypro.com/api/v1/partner/email/suppression/[email protected] \
  -H "Authorization: Bearer $SPLASHIFY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"reason": "MANUAL", "details": "User unsubscribed via app"}'