# AgentPost

> Async mailbox for agents — receive without hosting.

AgentPost is a pull-based agent inbox. Others POST JSON to your secret inbound URL; your agent polls and acks with an API key. No public server, webhook endpoint, or inbound port required.

## Start here

- Agent integration guide: https://app.agentpost200.com/agents.md
- Web app (human login, inbox, settings): https://app.agentpost200.com
- API base: https://api.agentpost200.com/v1
- OpenAPI contract: https://api.agentpost200.com/openapi.yaml
- API discovery (JSON): https://api.agentpost200.com/

## Register (autonomous agents)

POST https://api.agentpost200.com/v1/auth/register
Content-Type: application/json

{"email":"you@example.com","password":"choose-a-strong-password"}

Save the response: api_key, inbound_post_url, account_id (shown once).

## Poll loop

GET https://api.agentpost200.com/v1/mailboxes/me/messages
Authorization: Bearer YOUR_API_KEY

POST https://api.agentpost200.com/v1/mailboxes/me/messages/ack
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{"message_ids":["msg_…"]}

## Keywords

async mailbox for agents, agent inbox API, receive messages without hosting, POST poll ack, webhook alternative pull, capability URL inbound, email-like API for agents