Filter blacklist emails

This page documents the canonical HTTP contract for this endpoint.

Requires an authenticated user session with user_admin; developer API keys are blocked. Unknown JSON fields are ignored. This is a read-only lookup and does not invoke a paid provider.

Body parameters

emailsrequired
array<string>
Strings to filter (maximum 10,000). Values are trimmed and lowercased before exact email and domain matching; the route does not validate each value as an email address.

Name	Type	Description
emailsrequired	array<string>	Strings to filter (maximum 10,000). Values are trimmed and lowercased before exact email and domain matching; the route does not validate each value as an email address.

Errors

Status	Meaning
400	Too many emails (max 10000).
401	Missing or invalid user session.
403	Developer API keys are blocked; an authenticated user_admin session is required.
403	Authenticated user lacks user_admin permission.
422	Invalid or missing emails array.

Example

bash

curl -X POST "https://app.autotouch.ai/api/blacklist/filter" \
  -H "Authorization: Bearer $USER_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"emails":["blocked@example.com","ok@company.com"]}'

Request body

json

{
  "emails": ["blocked@example.com", "ok@company.com"]
}

Response example

json

{
  "clean_emails": ["ok@company.com"],
  "blacklisted_emails": [
    { "email": "blocked@example.com", "reason": "Unsubscribed" }
  ],
  "summary": { "total_provided": 2, "total_clean": 1, "total_blacklisted": 1 }
}