Aliases

Create Alias

POST /aliases/

Forward emails from one address to another. Supports catch-all rules.

Request Body

Field	Type	Required	Description
domain_name	string	Yes	Parent domain (must exist)
source	string	Yes	Source address or @domain.com for catch-all
destination	string	Yes	Destination email address

Regular Alias

curl -X POST https://api.emboux.com/aliases/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "domain_name": "mycompany.com",
    "source": "[email protected]",
    "destination": "[email protected]"
  }'

Catch-All Alias

Forward all unmatched addresses to a single mailbox:

curl -X POST https://api.emboux.com/aliases/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "domain_name": "mycompany.com",
    "source": "@mycompany.com",
    "destination": "[email protected]"
  }'

Response 201 Created

{
  "id": 1,
  "domain_id": 1,
  "source": "[email protected]",
  "destination": "[email protected]",
  "created_at": "2025-01-15T10:35:00"
}

Errors

Status	Detail
400	Alias source already exists
403	Alias quota exceeded
404	Domain not found

---

List Aliases

GET /aliases/?domain_id={id}

Query Parameters

Parameter	Type	Required	Description
domain_id	integer	No	Filter by domain

Example

curl "https://api.emboux.com/aliases/?domain_id=1" \
  -H "Authorization: Bearer YOUR_API_KEY"

---

Delete Alias

DELETE /aliases/{source}

Example

curl -X DELETE "https://api.emboux.com/aliases/[email protected]" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response 204 No Content