Add HBL to Monitoring

Request

Adds an HBL entity (e.g. an email address) to monitoring. The domain the entity belongs to must already be monitored. The entity is normalized before it is stored. No more than 10 entities per HBL type can be monitored per domain.

Security

basicAuth

Bodyapplication/jsonrequired

domainstringrequired

The monitored domain the entity belongs to.

hbl_typestringrequired

Type of HBL content (e.g., 'email').

entitystringrequired

The HBL entity (e.g., an email address).

curl -i -X POST \
  -u '<username>:<password>' \
  https://api.mailgun.net/v1/monitoring/hbls \
  -H 'Content-Type: application/json' \
  -d '{
    "domain": "example.com",
    "hbl_type": "email",
    "entity": "user@example.com"
  }'

Responses

A 200 response

Bodyapplication/json

entitystringrequired

Normalized entity.

Response

{
  "entity": "user@example.com"
}