Tenvio Docs
Manage multiple sender identities.
Sender identity, configured state, effective state, TLS policy, last use, and safe delivery counts remain independent for each sender.
Routes
| Route | Scope |
|---|---|
GET /v1/domains/{id}/senders
|
senders:read
|
POST /v1/domains/{id}/senders
|
senders:write
|
GET /v1/senders/{id}
|
senders:read
|
PATCH /v1/senders/{id}
|
senders:write
|
DELETE /v1/senders/{id}
|
senders:write
|
Create
Request body
{"email":"alerts@customer.example","display_name":"Security alerts","transport_security_policy":"require_tls"}
The email domain must equal the nested domain. A display name is trimmed, nonempty, at most 128 Unicode scalars and 256 UTF-8 bytes, and contains no control characters. The transport policy is require_tls or explicit opportunistic.
Update and delete
PATCH accepts display name and/or transport policy. A semantic no-op leaves updated_at unchanged. DELETE disables and soft-deletes the sender while retained email history remains available.
Malformed, unknown, deleted, and foreign sender IDs return sender_not_found. The nested collection returns domain_not_found for malformed, unknown, deleted, or foreign domains.