Skip to content

Add a target

POST /v1/blacklist/targets

Request

Field	Type	Required	Description
`value`	string	Yes	A domain (`example.com`) or an IP address, v4 or v6.
`label`	string	No	Your own name for it, e.g. `Primary sending IP`. Max 120 characters.
`monitoring_enabled`	boolean	No	Defaults to `true`. Set `false` to enroll without scheduling checks.

Whether value is a domain or an address is decided for you, and the value is normalized before it’s stored: Example.COM. and example.com are one target.

curl -X POST https://api.tryverifyemail.com/v1/blacklist/targets \
  -H "Authorization: Bearer sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"value": "203.0.113.24", "label": "Primary sending IP"}'

const res = await fetch("https://api.tryverifyemail.com/v1/blacklist/targets", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.VERIFYEMAIL_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ value: "203.0.113.24", label: "Primary sending IP" }),
});

const { created, target } = await res.json();

import os, requests

res = requests.post(
    "https://api.tryverifyemail.com/v1/blacklist/targets",
    headers={"Authorization": f"Bearer {os.environ['VERIFYEMAIL_API_KEY']}"},
    json={"value": "203.0.113.24", "label": "Primary sending IP"},
)

payload = res.json()

Response

201 Created on first enrollment. The target is described field by field on the target object.

{
  "created": true,
  "target": {
    "id": "665f1c2a9b4e7d0012ab34cd",
    "kind": "ipv4",
    "value": "203.0.113.24",
    "label": "Primary sending IP",
    "status": "pending",
    "monitoring_enabled": true,
    "listed_on": [],
    "last_checked_at": null,
    "next_check_at": "2026-08-21T10:04:11.000Z",
    "webhook_configured": false,
    "created_at": "2026-08-21T10:04:11.000Z",
    "updated_at": "2026-08-21T10:04:11.000Z"
  }
}

A value that is neither an IP address nor a plausible domain answers 400.

See also