agentmail

Troubleshooting

If requests fail, run zero doctor check-connector --env-name AGENTMAIL_TOKEN or zero doctor check-connector --url https://api.agentmail.to/v0/inboxes --method POST

Scenarios

1. Customer Support Agent

An AI agent handles inbound support emails automatically.

1. Create a dedicated inbox for support: POST /v0/inboxes with username: "support"
2. Register a webhook listening for message.received: POST /v0/webhooks with inbox_ids scoped to the support inbox
3. When a customer emails support@agentmail.to, the webhook fires with the message payload
4. Read the full thread for context: GET /v0/inboxes/{inbox-id}/threads/{thread-id}
5. Generate a response with your LLM, then reply in-thread: POST /v0/inboxes/{inbox-id}/messages/{message-id}/reply
6. Update labels to track state: PATCH /v0/inboxes/{inbox-id}/messages/{message-id} with add_labels: ["replied"], remove_labels: ["unreplied"]
7. Periodically check for stale threads: GET /v0/inboxes/{inbox-id}/threads?labels=unreplied to find conversations that still need attention

2. Sales Outreach with Scheduled Follow-ups