Intakes

An Intake is an account-owned capture URL. Create it in the console, then POST forms to /intake/{id}.

Submit vs Intake

/submit/you@example.com is the public try path. It needs no account, delivers to that inbox, and is limited to 200 events per month.

/intake/your-id is the product after you sign up. Limits, destinations, and origin controls belong to your account — not to an email in the URL.

form action
<form action="https://api.postme.dev/intake/your-id" method="POST">
  …
</form>

Setup

  1. Create a free account and open the console.
  2. Add at least one destination (email or webhook) and verify the inbox if you use email.
  3. Create an Intake, copy its URL, and replace any /submit/you@email demo action. Public submit never appears in Inbox.
An Intake with no ready destination returns no_routing. Email destinations that still need confirmation do not block webhooks or Discord if those are already attached.

Allowed origins

Optionally restrict an Intake to specific hostnames. When the list is empty, any site may POST. When it is set, the request Origin or Referer host must match. Otherwise the submit fails with origin_blocked. This is a browser hint, not a security boundary — a non-browser client can omit those headers.

Agents and scripts

An Intake URL is a POST endpoint. Agents, cron jobs, and curl can send mail this way. There is no Turnstile on /intake. Public /submit is the human demo and does require a token — do not point an agent at it.

curl
curl -s -X POST https://api.postme.dev/intake/your-id \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"name":"Agent","message":"Done.","_subject":"Agent note"}'
Leave the origin allowlist empty, or omit Origin and Referer from the request. Do not send a filled _postme_hp field.

Plans

  • Hobby — 500 events / month, up to 5 Intakes, email and webhook destinations.
  • Pro — 5,000 events / month, up to 50 Intakes, Discord, destination shapes, and auto-reply from your sending domain.

Inbox rows on Hobby are kept for 30 days. Pro keeps them until you delete them. Usage for the current month is billed either way. See Inbox.