Skip to main content
Allow and block rules give you explicit control over which addresses your agents can send to or receive from. You can block an entire competitor domain from outbound sends, reject mail from known spam senders before it reaches an inbox, or lock down a sensitive address so only permitted senders can reach it — all without touching your agent code.

​
Add a rule

Send a POST request to /lists with the rule’s kind, direction, and pattern:
cURL
curl -X POST https://sentvia-api-production.up.railway.app/v1/lists \
  -H "Authorization: Bearer sv_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "kind": "block",
    "direction": "outbound",
    "pattern": "competitor.com"
  }'
FieldValues
kindallow or block
directioninbound, outbound, or both
patternA full address (spam@example.com) or a bare domain (example.com)

​
How rules apply

  • Block (outbound) — sends to a matching recipient address are silently dropped from the recipient list. If no deliverable recipients remain after filtering, the send returns 422.
  • Block (inbound) — mail from a matching sender is rejected before it reaches any inbox. The sending server receives a rejection; nothing is stored.
  • Allow — explicitly permits an address or domain that might otherwise be filtered by another rule.

​
List and remove rules

Retrieve all rules in your workspace with GET /lists. Remove an individual rule with DELETE /lists/{id} using the id returned when you created it:
cURL
# List all rules
curl https://sentvia-api-production.up.railway.app/v1/lists \
  -H "Authorization: Bearer sv_live_..."

# Delete a rule
curl -X DELETE https://sentvia-api-production.up.railway.app/v1/lists/lst_... \
  -H "Authorization: Bearer sv_live_..."

​
Automatic suppression

Separately from your rules, Sentvia maintains an automatic suppression list. Any address that produces a hard bounce or files a spam complaint is added to the suppression list immediately — Sentvia will never attempt to send to that address again.
The suppression list is managed entirely for you. It operates independently of your allow/block rules and is designed to protect your sending reputation without any configuration on your part.