Home > Documentatie > API's en webhooks > Webhooks > Webhooks voor spamklachten

Webhooks: abuses

Als je een Webhook voor abuses instelt, word je in real-time op de hoogte gebracht van spamklachten. Een abuse ontstaat wanneer een ontvanger een e-mail als spam markeert bij zijn mailboxprovider. Voor elke spamklacht sturen we via HTTP of HTTPS een POST bericht naar jouw server met de relevante informatie.

Met deze Webhook kun je spamklachten automatisch verwerken in je eigen systemen, bijvoorbeeld om profielen te blokkeren of interne meldingen te versturen.

Variabelen

Met elk POST bericht worden de volgende variabelen meegestuurd:

Variabele Omschrijving
id Unieke identifier van het bericht waarover geklaagd is
type Type van de actie die de Webhook triggerde ('abuse')
timestamp Tijdstempel van de spamklacht (YYYY-MM-DD HH:MM:SS)
time Unix timestamp van de spamklacht
recipient E-mailadres van de ontvanger
referer URL waar de spamklacht is geregistreerd
tags Tags geassocieerd met het bericht

De variabelen id, recipient en tags stellen je in staat om de binnenkomende spamklacht te koppelen aan de oorspronkelijke mailing.

Voorbeeld payload

Onderstaand voorbeeld laat zien hoe de JSON payload eruitziet die je ontvangt:

{
    "id": "cdm/testdestinationid",
    "type": "abuse",
    "recipient": "recipient@example.com",
    "time": 1767615096,
    "timestamp": "2026-01-05 13:11:36",
    "referer": "https://copernica.com",
    "tags": "tag1;tag2;tag3"
}

Meer informatie