Skip to content
Engineering

Building on the InstantEduMail API

Create mailboxes, stream inbound mail and wire webhooks with a handful of requests.

INInstantEduMail Editorial Team8 min readUpdated 14 August 2026

Authenticate

Every request carries a bearer key scoped to the permissions you granted it.

bash
curl https://api.instantedumail.com/v1/mailboxes \
  -H "Authorization: Bearer $INSTANTEDUMAIL_API_KEY"

Create a mailbox

ts
const res = await fetch("https://api.instantedumail.com/v1/mailboxes", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.INSTANTEDUMAIL_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ address: "cohort-2027", label: "Orientation" }),
});

const mailbox = await res.json();

Receive mail with webhooks

Register an https endpoint and subscribe to email.received. Every delivery is signed; verify before you trust it.

Rate limits

Limits are per key and returned on every response in X-RateLimit-Remaining. Back off on 429 using the Retry-After header.

Scopes

Grant the narrowest scope that works. A read-only integration should never hold emails:write.

Share

About the author

InstantEduMail Editorial Team

Editorial Team

Guides on temporary email, deliverability and email testing, written and reviewed by the InstantEduMail team against primary sources. Read our editorial policy for how we research, review and correct content.

All posts by InstantEduMail Editorial Team

Comments are coming soon

We're wiring up a moderated discussion thread for each post. Until then, reply by email and we'll add good questions to the article.

Send us a note

Related reading