logo
Mail Forwarding (User)Create Alias (cURL)

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
Required

The local-part (handle) of your alias. Example: docs.curl

query
domainstring
Required

The domain for your alias. Example: fwd.haltman.io

query
tostring
Required

The 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'
cURL alias creation

Confirm your email (anti-abuse)

A confirmation email is sent to the destination address. Click the link to activate.

Confirmation sent Confirmed

Test your new alias

Test email