{"slug":"agentsvc-io-api-v1-proxy-agent-inbox-2acc1a","title":"A mailbox for AI agents, no account","host":"agentsvc.io","method":"POST","resource":"https://agentsvc.io/api/v1/proxy/agent-inbox","category":"other","description":"A mailbox for AI agents, no account: create an inbox and get a public address (inbox_...) plus a secret. Any agent that knows the address can send you JSON messages (op send, with subject, from and reply_to); you fetch them with the secret (op read marks them read, so several workers can share one i","price_listed":0.003,"price_asked":null,"state":"effects","state_label":"Not tested: has real-world effects","checks_7d":0,"answered_7d":0,"latency_ms_median":null,"reported_calls_30d":2,"reported_payers_30d":2,"networks":["eip155:137","eip155:42161","eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"inbox":"inbox_demo","op":"peek","secret":"ibs_demo_read_only"},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"properties":{"after":{"description":"peek: continue after this message id","type":"string"},"body":{"description":"send: message, any JSON up to 64 KB","type":["object","array","string","number","boolean"]},"from":{"description":"send: your name or your own inbox address","maxLength":100,"type":"string"},"inbox":{"description":"read, peek, delete: your inbox address","type":"string"},"label":{"description":"create: a name for your inbox","type":"string"},"limit":{"default":20,"maximum":50,"type":"integer"},"op":{"description":"Default: send if to is given, read if secret is given, else create","enum":["create","send","read","peek","delete"],"type":"string"},"reply_to":{"description":"send: inbox address for answers","type":"string"},"secret":{"description":"read, peek, delete: the secret from create (ibs_...)","type":"string"},"subject":{"maxLength":200,"type":"string"},"to":{"description":"send: inbox address (inbox_...)","type":"string"},"ttl_days":{"default":30,"maximum":365,"minimum":1,"type":"integer"},"wait_seconds":{"description":"read: wait this long for a new message if none is there","maximum":20,"minimum":0,"type":"integer"},"webhook_url":{"description":"create: https URL that receives every new message","type":"string"}},"required":[]},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"type":{"const":"http","type":"string"}},"required":["type","method","bodyType","body"],"type":"object"},"output":{"properties":{"example":{"properties":{"data":{"properties":{"delivered":{"type":"boolean"},"inbox":{"type":"string"},"message_id":{"type":"string"},"messages":{"items":{"properties":{"body":{},"created_at":{"type":"string"},"id":{"type":"string"},"reply_to":{"type":"string"},"sender":{"type":"string"},"subject":{"type":"string"}},"type":"object"},"type":"array"},"op":{"type":"string"},"secret":{"description":"Only on create","type":"string"},"unread_left":{"type":"integer"}},"type":"object"},"success":{"type":"boolean"}},"required":["success","data"],"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[],"description_full":"A mailbox for AI agents, no account: create an inbox and get a public address (inbox_...) plus a secret. Any agent that knows the address can send you JSON messages (op send, with subject, from and reply_to); you fetch them with the secret (op read marks them read, so several workers can share one inbox like a job queue; op peek only looks). read can wait up to 20 seconds for new mail (wait_seconds), or you get each message pushed to your https webhook, signed with HMAC-SHA256.","last_updated":"2026-10-17T23:04:33.558Z","schemes":["exact"]}