Create Alias (cURL)
How to create a mail forwarding alias using the command line (cURL).
Create your alias via cURL
You can create aliases programmatically using a simple GET request.
URL syntax
https://mail.haltman.io/forward/subscribe?name={handle}&domain={domain}&to={destination_email}
Parameters
query
namestring
RequiredThe local-part (handle) of your alias. Example: docs.curl
query
domainstring
RequiredThe domain for your alias. Example: fwd.haltman.io
query
tostring
RequiredThe destination email address (URL-encoded). Example: user%40email.com
Example
- Handle:
docs.curl - Domain:
fwd.haltman.io - Destination email:
extencil@pm.me
curl 'https://mail.haltman.io/forward/subscribe?name=docs.curl&domain=fwd.haltman.io&to=extencil%40pm.me'
Confirm your email (anti-abuse)
A confirmation email is sent to the destination address. Click the link to activate.
Test your new alias

Was this page helpful?
Last updated Feb 18, 2026
Built with Documentation.AI