> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sentfrom.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Allow & block lists

> Control which addresses your agents can email or receive from.

Allow/block **rules** let you explicitly permit or deny specific addresses or
domains, on top of the automatic suppression of bounces and complaints.

## Add a rule

```bash theme={null}
curl -X POST https://api.sentfrom.ai/v1/lists \
  -H "Authorization: Bearer sf_live_…" -H "Content-Type: application/json" \
  -d '{ "kind": "block", "direction": "outbound", "pattern": "competitor.com" }'
```

| Field       | Values                                                   |
| ----------- | -------------------------------------------------------- |
| `kind`      | `allow` or `block`                                       |
| `direction` | `inbound`, `outbound`, or `both`                         |
| `pattern`   | A full address (`spam@x.com`) or a bare domain (`x.com`) |

List and remove with `GET /lists` and `DELETE /lists/{id}`.

## How rules apply

* **Block (outbound)** — sends to a matching recipient are dropped; if none remain, the send returns `422`.
* **Block (inbound)** — mail from a matching sender is rejected before it reaches an inbox.
* **Allow** — explicitly permits an address that might otherwise be filtered.

## Automatic suppression

Separately from your rules, SentFromAI maintains an automatic **suppression list**: any
address that hard-bounces or files a spam complaint is suppressed so you never send
to it again. This is managed for you — it protects your sending reputation without
any configuration.