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": "user@example.com",
  "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://apis.splashifypro.com/api/v1/partner/email/suppression/user@example.com \
  -H "Authorization: Bearer $SPLASHIFY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"reason": "MANUAL", "details": "User unsubscribed via app"}'