One API call mints an inbox. Webhooks fire when a human replies. Built for products that provision a mailbox per tenant — not for cheap bulk send.
No credit card
from voru_agentbox import AgentBox
client = AgentBox("ab_live_...", base_url="https://voru.org")
inbox = client.inboxes.create(username="billing")
client.inboxes.send(
inbox["inbox_id"],
to="ops@acme.com",
subject="Workspace ready",
text="Reply in this thread.",
)billing@agent.voru.orgAddresses look like this on agent.voru.org. Open a workspace to mint a real one.
Create an inbox in the console, then send and receive through the API.
POST /v1/inboxes
GET /v1/inboxes/{id}
client_id makes create idempotent.
metadata is yours to store.Browser agents, assistants, document intake, support routing — each one gets its own mailbox.
inbox = client.inboxes.create(username="signup") # put inbox["inbox_id"] in the signup form msg = client.inboxes.messages(inbox["inbox_id"])["messages"][0] code = msg["codes"][0]
Call https://voru.org/v1. TypeScript: npm i voru-agentbox. Python installs from the wheel on this site until it is on PyPI.
pip install https://voru.org/sdk/voru_agentbox-0.1.0-py3-none-any.whl npm i voru-agentbox curl.exe -fsS https://voru.org/v1/openapi.json
PowerShell’s curl is Invoke-WebRequest and prints an object. Use curl.exe so the JSON prints as text. On macOS and Linux, drop the .exe.
An inbox API. You create an address per customer or agent, then send, receive, and subscribe to events.
SaaS teams who want one mailbox per customer or agent — create, watch, and delete it from the API.
Create, list, send, reply, threads. IMAP clients use agent.voru.org (port 1993) with the inbox credentials from the API.
message.received, sent, bounced. HMAC signed. Or listen on the WebSocket at /v1/ws.
One pod per customer in your product. Map with client_id so you do not store our IDs.
SPF, DKIM, DMARC generated. Unverified domains cannot send. Free tier stays on ours, on purpose.
A custom domain, a third inbox, or sending past the allowlist — any of those is the upgrade.
Try the API on our domain.
The first real product plan.
One box per customer.