{"id":"inbox-create","title":"Receive-only inbox for agents without a public endpoint","description":"Creates a receive-only inbox for an AI agent that has no public endpoint: a webhook URL that accepts POST or PUT, and (when the operator has configured inbound email) a unique email address. Pair with inbox-poll to read what arrived. It never sends email or calls out, does not store attachments, does not verify senders (no SPF/DKIM), and message content is untrusted third-party data. Inboxes live 7 days from creation with no extension; at most 20 live inboxes per payer. A 21st inbox is rejected with 429 inbox_limit and the payment is kept because the limit is the caller's own. Limits per inbox: 500 messages, 256 KB stored per message, 60 webhook deliveries per minute. email_status is not_configured when this deployment has no inbound email domain, in which case only the webhook works.","roi":"An agent behind NAT or on a serverless function gets a durable address that third parties can POST to or email, and polls it later, with no server to run.","audience":"agent-infra","channels":["x402","mcp"],"endpoint":{"method":"POST","url":"https://agents.writerslogic.com/api/v1/inbox-create","path":"/api/v1/inbox-create","contentType":"application/json"},"price":{"amount":"0.25","currency":"USDC","network":"base","perCall":true,"failedCallsCharged":false},"inputSchema":{"type":"object","additionalProperties":false,"properties":{"label":{"type":"string","maxLength":64,"description":"Optional name for your own bookkeeping."},"tenantId":{"type":"string","pattern":"^[A-Za-z0-9_.-]{1,64}$","description":"Required for API-key callers (namespace as key:<tenantId>; keep it unguessable). Ignored when a wallet paid."}}},"resultSchema":{"type":"object","properties":{"inbox_id":{"type":"string"},"tenant":{"type":"string"},"label":{"type":"string"},"email_address":{"anyOf":[{"type":"string","description":"Null when inbound email is not configured."},{"type":"null"}]},"email_status":{"type":"string","enum":["ready","not_configured"]},"webhook_url":{"type":"string","description":"POST or PUT here; the URL itself is the secret."},"webhook_token":{"type":"string"},"created_at":{"type":"integer"},"expires_at":{"type":"integer"},"limits":{"type":"object","description":"Every limit this service enforces, plus what it does not do."}}},"outputSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"inbox_id":{"type":"string"},"tenant":{"type":"string"},"label":{"type":"string"},"email_address":{"anyOf":[{"type":"string","description":"Null when inbound email is not configured."},{"type":"null"}]},"email_status":{"type":"string","enum":["ready","not_configured"]},"webhook_url":{"type":"string","description":"POST or PUT here; the URL itself is the secret."},"webhook_token":{"type":"string"},"created_at":{"type":"integer"},"expires_at":{"type":"integer"},"limits":{"type":"object","description":"Every limit this service enforces, plus what it does not do."}}},"_provenance":{"type":"object","description":"C2PA-aligned manifest and W3C VC 2.0 (eddsa-jcs-2022) issued by the hub DID; verify at POST /api/v1/verify-provenance"}},"required":["data","_provenance"]},"example":{"label":"order-callbacks"},"openapiOperation":{"operationId":"inbox_create","summary":"Receive-only inbox for agents without a public endpoint","description":"Creates a receive-only inbox for an AI agent that has no public endpoint: a webhook URL that accepts POST or PUT, and (when the operator has configured inbound email) a unique email address. Pair with inbox-poll to read what arrived. It never sends email or calls out, does not store attachments, does not verify senders (no SPF/DKIM), and message content is untrusted third-party data. Inboxes live 7 days from creation with no extension; at most 20 live inboxes per payer. A 21st inbox is rejected with 429 inbox_limit and the payment is kept because the limit is the caller's own. Limits per inbox: 500 messages, 256 KB stored per message, 60 webhook deliveries per minute. email_status is not_configured when this deployment has no inbound email domain, in which case only the webhook works.\n\nPrice: 0.25 USDC on Base (x402).","x-x402-price-usdc":"0.25","x-x402-amount":"250000","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.25"}},"x-audience":"agent-infra","x-sample-url":"https://agents.writerslogic.com/api/v1/samples/inbox-create","security":[{"x402":[]},{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"label":{"type":"string","maxLength":64,"description":"Optional name for your own bookkeeping."},"tenantId":{"type":"string","pattern":"^[A-Za-z0-9_.-]{1,64}$","description":"Required for API-key callers (namespace as key:<tenantId>; keep it unguessable). Ignored when a wallet paid."}}},"example":{"label":"order-callbacks"}}}},"responses":{"200":{"description":"Paid result with provenance","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"inbox_id":{"type":"string"},"tenant":{"type":"string"},"label":{"type":"string"},"email_address":{"anyOf":[{"type":"string","description":"Null when inbound email is not configured."},{"type":"null"}]},"email_status":{"type":"string","enum":["ready","not_configured"]},"webhook_url":{"type":"string","description":"POST or PUT here; the URL itself is the secret."},"webhook_token":{"type":"string"},"created_at":{"type":"integer"},"expires_at":{"type":"integer"},"limits":{"type":"object","description":"Every limit this service enforces, plus what it does not do."}}},"_provenance":{"type":"object","description":"C2PA-aligned manifest and W3C VC 2.0 (eddsa-jcs-2022) issued by the hub DID; verify at POST /api/v1/verify-provenance"}},"required":["data","_provenance"]}}}},"400":{"description":"Invalid request (no payment consumed)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Invalid X-API-KEY","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Payment required or invalid","content":{"application/json":{"schema":{"type":"object","description":"x402 v2 PaymentRequired (also base64 in the PAYMENT-REQUIRED header)","properties":{"x402Version":{"type":"integer"},"error":{"type":"string"},"code":{"type":"string"},"resource":{"type":"object"},"accepts":{"type":"array","items":{"type":"object"}},"extensions":{"type":"object"}}}}}},"502":{"description":"Upstream failure; the payment is released or not settled","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}}},"links":{"docs":"https://agents.writerslogic.com/docs/inbox-create/","docsJson":"https://agents.writerslogic.com/docs/inbox-create.json","sample":"https://agents.writerslogic.com/api/v1/samples/inbox-create","openapi":"https://agents.writerslogic.com/openapi.json","catalog":"https://agents.writerslogic.com/api/v1/catalog","verifyProvenance":"https://agents.writerslogic.com/api/v1/verify-provenance","index":"https://agents.writerslogic.com/docs/index.json"}}