@
All docs

Getting started

Create your first alias on emailforward.xyz in about 90 seconds. No account, no confusing steps.

emailforward.xyz is an email alias forwarder. You create a random alias, hand it out instead of your real address, and we route everything that lands on it to whoever you tell us to — one to six recipients, email or Telegram.

1. Create an alias

On the homepage, click Create alias now and pass the Turnstile challenge. We mint a random address like [email protected] and drop you on the setup page.

Want something memorable? Fill in the prefix field before creating — [email protected] is yours if nobody else has claimed it. Leave the field blank to get a random local part. Reserved names like admin or postmaster are blocked.

2. Add recipients

An alias is just a pass-through; it needs somewhere to send mail. You have two options:

  • Email recipient. Type any inbox you control. We send a one-off verification link. Click it once, forever after mail routes there.
  • Telegram recipient. Tap the Telegram option to get a deep-link (for DMs) or a /verify CODE (for groups and channels). Once linked, forwards arrive in chat.

Each alias accepts up to 6 recipients, any mix of email and Telegram. Every recipient verifies once.

3. Share the alias

That's it. Give the alias to whoever needs it — signups, newsletters, a relative, anything. We forward to every verified recipient. Unverified recipients still show up on your dashboard but don't receive mail until they click their link.

4. Manage later

You can reach any alias two ways:

  • Direct link. The setup page URL is bookmarkable: /setup/:shortId. Save it the first time; lose it and you can still recover from the next option.
  • Management hub. Visit /manage-email, enter any verified recipient email, and we send a 24-hour management link. From there you see every alias tied to that inbox.

From the manage page you can:

  • Add or remove recipients.
  • Pause the alias (keeps accepting mail, stops forwarding).
  • Delete the alias permanently (wipes recipients, history, pairings).

The /manage-email dashboard is organised in four tabs: Aliases (create + list), Telegram, Domains, API.

5. Reply through the alias

Every forwarded email sets a reply address that routes back through us. Hit Reply in your mail client — we relay the message to the original sender with the alias as the From. They never see your real inbox. Replies work for aliases at @emailforward.xyz; custom-domain reply support is coming later.

6. Bring your own domain

Want [email protected] instead of @emailforward.xyz? From /manage-email → Domains:

  1. Add your domain. We show a TXT record to publish.
  2. Set the MX for that domain to mail.emailforward.xyz with priority 10.
  3. Publish the TXT and hit Verify. DNS can take a few minutes.
  4. Once verified, the Aliases tab lets you pick your domain from the dropdown when minting a new alias.

Everything else — recipients, Telegram, history — works the same on your domain.

7. Automate with the API

For scripts or other apps, sign in at /manage-email → API, create a token, and hit POST /api/v1/aliases with Authorization: Bearer …. Aliases created via API auto-forward to your inbox, already verified.

Full reference: /docs/api.

8. Pair Telegram once, for everything

If you want all aliases tied to a given inbox to also deliver to Telegram, use the inbox-wide pairing: /manage-email → Add chat. One setup, every existing and future alias routed to that inbox now also drops into the paired chat.

See the Telegram setup doc for DM, group and channel specifics.

What's next