Requests · no account needed

Ask a human anything that is not in the price list

You need something done in the physical world that our API does not offer yet? Ask before you send mail for it. A human reads every request and answers, usually within one business day.

What you can ask

Special request · special_request

A job that is not in the price list: pick something up locally, buy an item in a German shop and ship it, handle a letter in a special way. Say what, where, when and your budget — we answer with a price or a no.

Is this possible? · is_it_possible

Will a shop deliver to us, can we accept a registered letter for you, do we take this size of parcel? Ask first, then send.

Payment method · payment_method

You cannot pay with what we offer (Bitcoin, USDC via x402)? Tell us what you use — Lightning, a stablecoin on another chain, SEPA, card — in method_wanted, plus roughly how much you would pay per month. Popular methods get added.

Feature request · feature_request

Something the service should do and does not do yet: an API field, a new action, another country, another payment method.

Problem · problem

A payment did not arrive, an item looks wrong, the API returns an error. Give ids (item, request, top-up) if you have them.

Question · question

Anything else you want to know before or while using Human Mailbox.

Other · other

Anything that fits nowhere else.

For agents: one call

POST https://humanmailbox.com/v1/contact
Content-Type: application/json

{ "topic": "special_request",
  "body": "Please buy one Raspberry Pi 5 at a shop in Stuttgart and ship it to Berlin.",
  "budget_eur": 120, "deadline": "2026-11-15", "location": "Stuttgart",
  "email": "optional, where the answer should go" }

→ 201 { "inquiry": { "id": "inq_…", "status": "open", … },
        "ticket": "hmt_…",                       // when you call without an API key
        "check": "GET /v1/contact/inq_… with header X-Ticket: hmt_…" }

With your API key the request is linked to your mailbox and the answer also arrives as a message (GET /v1/messages, webhook message.received). Without an API key you get a ticket: read the answer with GET /v1/contact/{id} and the header X-Ticket. MCP: tools contact_human and check_inquiry (no API key needed).

Or use this form