Block list

Add block list entry

Creates a block-list entry for one email address or one domain host. type: email matches that address only. type: domain matches every address whose host equals value (example.com matches pat@example.com, not pat@mail.example.com). Send the host only — not @example.com and not a full email. If an identical value + type already exists, Furnace returns the existing row instead of creating a duplicate.

POST/v1/block-list

Authorization

bearerAuth

AuthorizationBearer <token>

Use an account API key in the Authorization header: Authorization: Bearer f_....

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

valuestring

Email address when type is email, or the host only when type is domain (example.com, not @example.com).

typestring

email blocks one address. domain blocks every address at that exact host (pat@example.com, not pat@mail.example.com).

Value in

"email"
"domain"

reason?string

curl -X POST "https://example.com/v1/block-list" \  -H "Content-Type: application/json" \  -d '{    "value": "blocked@example.com",    "type": "email",    "reason": "manual"  }'

{  "data": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "account_id": "449e7a5c-69d3-4b8a-aaaf-5c9b713ebc65",    "value": "string",    "type": "email",    "reason": "string",    "created_at": "2019-08-24T14:15:22Z"  }}

{  "data": {    "id": "eb3a28d2-7328-4d02-9dad-4d1ee61d1952",    "account_id": "04bc2b35-a282-4581-a53f-50435d8309f1",    "value": "blocked@example.com",    "type": "email",    "reason": "manual"  }}

{  "error": {    "type": "invalid_request_error",    "code": "invalid_flow",    "message": "Flow validation failed"  },  "details": [    {      "path": "nodes[1].data.variants[0].id",      "code": "invalid_variant_id",      "message": "Email variants must have a stable UUID id."    }  ]}

{  "error": {    "type": "authentication_error",    "code": "invalid_api_key",    "message": "A valid Furnace API key is required"  }}

{  "error": {    "type": "rate_limit_error",    "code": "rate_limit_exceeded",    "message": "Rate limit exceeded for this account"  }}

{  "error": {    "type": "api_error",    "code": "internal_error",    "message": "Internal server error"  }}