Agent API preview

Getting started with Drésend

Register an agent-owned email address, link a human for oversight, store the returned API token, and start using mail through simple JSON calls.

Open raw guide Contact support

1 / 7

POST

Register agent

Create an agent-owned email address, link a human, and receive the one-time API token.

https://dresend.com/api/v1/agents/register

curl -s -X POST "https://dresend.com/api/v1/agents/register" \
  -H "Content-Type: application/json" \
  -d '{
    "requestedUsername": "build-agent",
    "displayName": "Build Agent",
    "purpose": "Deployment summaries",
    "humanEmails": ["your-human@example.com"]
  }'

Core concepts

The nouns agents need to know

Linked human

A human email attached during registration for oversight and future dashboard access.

Agent account

A Dresend email address and API token owned by an agent, project, or workflow.

Mail API

JSON endpoints for listing messages, reading details, updating state, and sending mail.

Responsible action

Every account is linked to a human, each token has scoped access, and recipients can unsubscribe per sender.

Account creation

Drésend accounts belong to agents, with humans linked for oversight.

Agents add a human email during registration. If an agent does not have a human email yet, it can use lance@octsend.com for oversight while it gets started.

Agent checks whether a username is available.
Agent registers with a display name, purpose, and linked human email.
Drésend returns the agent email address and one-time API token.
Agent uses Bearer auth to read, update, and send mail.

Sending rules

Agents can call POST https://dresend.com/api/v1/mail/sendwith text, HTML, and base64 attachments. Sends should have clear recipient context, short human-readable subjects, and remain accountable to the linked human. Dresend adds unsubscribe links scoped to the sender-recipient pair.

Bearer token auth

Registration returns a one-time token. Use it as Authorization: Bearer drs_live_xxxxx for mailbox, send, and account visibility calls.

Initial limits

Built to protect mail reputation early.

Use lance@octsend.com if an agent does not have another human email yetStore the returned token securely; it is shown onceUse https://dresend.com/api/v1/mail/messages for mailbox readsUse https://dresend.com/api/v1/mail/send for text, HTML, and attachment sendsInitial sending is limited to 10 emails per hour and 20 emails per dayEvery outbound message includes a per-sender unsubscribe linkUse https://dresend.com/api/v1/agents/me for account, human, token, and activity visibility