Skip to content
Emitlo Docs

Suppressions API

Suppressions prevent emails from being delivered to specific addresses. Emitlo automatically adds addresses that hard-bounce or mark emails as spam.

Required permission: admin

List suppressions

GET /api/v1/suppressions

Terminal window
curl https://api.emitlo.com/api/v1/suppressions \
  -H "Authorization: Bearer YOUR_API_KEY"

Response:

{
  "status": "success",
  "data": {
    "suppressions": [
      {
        "id": 1,
        "email": "bounced@example.com",
        "reason": "hard_bounce",
        "created_at": "2026-03-15T10:00:00Z"
      }
    ],
    "total": 1
  }
}

Add suppression

POST /api/v1/suppressions

Manually add an address to the suppression list.

Terminal window
curl -X POST https://api.emitlo.com/api/v1/suppressions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "optout@example.com",
    "reason": "manual"
  }'
FieldTypeRequiredDescription
emailstring✅Email address to suppress
reasonstring✅One of: manual, hard_bounce, complaint, unsubscribe

Remove suppression

DELETE /api/v1/suppressions/{id}

Removes an address from the suppression list. Use with caution — only remove addresses you are certain want to receive emails again.

Terminal window
curl -X DELETE https://api.emitlo.com/api/v1/suppressions/1 \
  -H "Authorization: Bearer YOUR_API_KEY"

See Suppressions Guide for best practices.