NODE.US-EAST-1 / ONLINE
v4.7.2·uplink 99.998%·p50 12ms
UTC --:--:--
[00 / INBOX API]  EMAIL WORKFLOWS FOR AGENTS

Give every
AI Agent an Inbox

Receive OTPs, magic links, alerts, and workflow emails
through a simple API.

INBOX API
READ / MARK / HANDLE
OTP PARSE
981742 sample
WEBHOOKS
HMAC signed
AUDIT
FULL history
[01 / CAPABILITIES]

Receive email. Extract what matters.

01

Dedicated Agent Inboxes

Create inboxes for agents to receive OTPs, invites, alerts, and platform email.

API READ · OTP PARSING · WEBHOOKS
02

Code and Link Extraction

PostRider parses verification codes and actionable links as soon as messages arrive.

p50 12ms · JSON PAYLOADS · AUDIT LOG
03

Scoped Agent Access

Issue keys so agents can read, mark, and handle messages without a shared human mailbox.

SCOPED TOKENS · HMAC · LOGGED
[02 / API]

Built for agents,
not shared inboxes.

  • +
    API-readable mailboxes
    Agents can list, read, and update incoming messages
  • +
    OTP and link parsing
    Verification codes and invite links become structured fields
  • +
    Signed webhook events
    New mail can trigger your agent workflow immediately
agent_flow.shopenapi.jsonauth.md
REAL ROUTES·v2026-05-01
01export POSTRIDER_BASE_URL="https://postriderai.com"
02export POSTRIDER_API_KEY="praa_secret"
03export INBOX_ID="inb_123"
04 
05curl -sS "$POSTRIDER_BASE_URL/api/agent/inboxes/$INBOX_ID/messages?limit=10&unread=true" \
06 -H "Authorization: Bearer $POSTRIDER_API_KEY"
07 
08export MESSAGE_ID="msg_123" # from data[0].id
09curl -sS "$POSTRIDER_BASE_URL/api/agent/messages/$MESSAGE_ID" \
10 -H "Authorization: Bearer $POSTRIDER_API_KEY"
11 
12# Use data.codes[0].value or data.links[0].url, then mark handled.
13curl -sS -X POST "$POSTRIDER_BASE_URL/api/agent/messages/$MESSAGE_ID/mark-handled" \
14 -H "Authorization: Bearer $POSTRIDER_API_KEY"
15 
16curl -sS -X PUT "$POSTRIDER_BASE_URL/api/agent/inboxes/$INBOX_ID/webhook" \
17 -H "Authorization: Bearer $POSTRIDER_API_KEY" \
18 -H "Content-Type: application/json" \
19 -d '{"webhook_url":"https://agent.example.com/postrider","webhook_signature_mode":"postrider"}'
$ list unread - read full message - mark handled - configure webhookAGENT_API
[03 / START]

Give every agent
an inbox.

CREATE AGENT INBOX
$ curl /api/agent/inboxes -H "Authorization: Bearer $POSTRIDER_API_KEY"