DocumentazioneLista di soppressione

Lista di soppressione

Bloccare invii a indirizzi con bounce, reclamo o disiscrizione.

Una soppressione e un indirizzo email che non deve ricevere altri messaggi. MailingCore blocca gli invii a indirizzi soppressi in coda — protegge reputazione e rispetta disiscrizioni GDPR.

Le soppressioni si creano automaticamente da bounce duri, reclami e flussi di disiscrizione. Puoi anche gestire la lista via API.

Scope richiesti

Operazione	Scope
Elencare / leggere	`suppressions:read`
Aggiungere	`suppressions:write`
Rimuovere	`suppressions:write`

Scope mancante restituisce 403 con Missing required API key scope.

Endpoint

Metodo	Endpoint	Descrizione
`GET`	`/suppressions`	Elencare indirizzi soppressi (paginato)
`POST`	`/suppressions`	Aggiungere indirizzo manualmente
`DELETE`	`/suppressions/:email`	Rimuovere soppressione (codifica email in URL)

Elencare

GET /suppressions?limit=50&cursor=...
Authorization: Bearer mc_live_xxxx
X-Tenant-Id: clxxxxxxxx

Aggiungere

POST /suppressions
Authorization: Bearer mc_live_xxxx
X-Tenant-Id: clxxxxxxxx
Content-Type: application/json

{
  "email": "[email protected]",
  "reason": "manual"
}

Valori comuni di reason: bounce, complaint, unsubscribe, manual.

Rimuovere

DELETE /suppressions/utente%40example.com
Authorization: Bearer mc_live_xxxx
X-Tenant-Id: clxxxxxxxx

Pannello

I contatti con suppressedAt impostato compaiono soppressi in Contacts. La lista resta sincronizzata con /suppressions.