Claim an alias

Create a mailbox alias on a domain already available to the account.

Required scopes: aliases:write · Base https://api.fatheron.dev

Steps

1. 1. Optional availability check

   GET /v1/aliases/check?local_part=hello&domain=example.com
   X-API-Key: fh_live_…

2. 2. Claim alias

   POST /v1/aliases
   X-API-Key: fh_live_…
   Content-Type: application/json
   
   {
     "local_part": "hello",
     "domain_name": "example.com",
     "forwards_to": "[email protected]"
   }

   201 response. status may be pending_destination until forward is verified.

Failure remediation

• domain_not_found

  Attach or claim the domain on the account first.

• address_taken

  Choose a different local_part.

• plan_limit_reached

  Upgrade plan or free an alias slot.

• domain_not_available

  Domain is hidden/unavailable for claim.

• catch_all_admin_only

  Do not use local_part *.

All agent recipes