Skip to content
Log in Start for free

AI Email Marketing

Blacklist

Addresses that are never emailed. Unsubscribes land here automatically; add your own opt-outs straight from a form.

GET/v1/suppressionsList suppressed addresses POST/v1/suppressionsSuppress an address

List suppressed addresses

GET/api/v1/suppressions

Newest first.

Any API key, read-only included.

Parameters

NameTypeDescription
per_page query integer Up to 200. Default 50.

Errors

  • 401Missing or invalid key
  • 422Invalid input, or not ready; the body has message and an errors object, one entry per field
  • 429More than 120 requests a minute
Request
curl https://app.zicreach.com/api/v1/suppressions \
  -H "Authorization: Bearer zk_your_key"
Response200
{
    "data": [
        {
            "email": "optout@example.com",
            "reason": "unsubscribed",
            "created_at": "2026-09-20T12:00:00Z"
        }
    ],
    "meta": {
        "current_page": 1,
        "last_page": 1,
        "total": 1
    }
}

Suppress an address

POST/api/v1/suppressions

The address is never emailed again by any campaign in this workspace.

Needs a read and write API key.

Body

NameTypeDescription
emailrequired string The address to suppress.
reason string Why, for your records. Default manual.

Errors

  • 401Missing or invalid key
  • 403Read-only key used for a change, or a key made by someone who is no longer an owner or admin
  • 422Invalid input, or not ready; the body has message and an errors object, one entry per field
  • 429More than 120 requests a minute
Request
curl -X POST https://app.zicreach.com/api/v1/suppressions \
  -H "Authorization: Bearer zk_your_key" \
  -H "Content-Type: application/json" \
  -d '{"email":"jane@example.com","reason":"unsubscribed"}'
Response201
{
    "message": "Address suppressed."
}