Create an email forwarder for your web hosting account

Set up an email address on your web hosting so that messages are forwarded to another email address. This is useful if you want to collect email from multiple addresses in one place or if you are changing email providers but want to keep your old address.

Web Hosting Services Email

Context

Where to get IDs / values

Path Parameters

accountId integer · min: 1 required Example: 20000

Unique account identifier

Headers

Accept Example
Content-Type Example

Body

required
application/json
destination string required · Example: [email protected]
domain string required · Example: example.com
email string required · Example: [email protected]

Responses

200
data object required
data.accountId string required · Example: 20000
data.cpanelUsername string required · Example: xkqjm
data.created boolean required · Example: true
data.destination array<string> required · Example: ["[email protected]"]
data.forwarder string required · Example: [email protected]
data.success boolean required · Example: true

True for successful responses.

requestId string required · Example: 2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba

Unique request identifier (UUID).

success boolean required · Example: true

True for successful responses.

timestamp string required · Example: 2026-02-10T00:00:00.000Z

ISO 8601 timestamp (UTC).

422
code string required · Example: VALIDATION_ERROR

Machine-readable error code.

details array<object> required · Example: [{"field":"email","message":"email has invalid format","code":"INVALID_FORMAT"}]

Optional validation details (field-level errors).

details[].code string · enum required · Example: INVALID_FORMAT

Machine-readable error code.

INVALID_FORMAT
REQUIRED
details[].field string · enum required · Example: email
destination
domain
email
details[].message string required · Example: email has invalid format

Human-readable message.

error string required · Example: Unprocessable Entity

HTTP status title (e.g. 'Bad Request').

message string required · Example: Validation failed

Human-readable message.

requestId string required · Example: 2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba

Unique request identifier (UUID).

timestamp string required · Example: 2026-02-10T00:00:00.000Z

ISO 8601 timestamp (UTC).

POST https://cloud.hostup.se/api/hosting/{accountId}/email-forwarders
For AI assistants
cURL 
curl -X POST "https://cloud.hostup.se/api/hosting/20000/email-forwarders" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "domain": "example.com",
    "destination": "[email protected]"
  }'
Response 
{
  "success": true,
  "timestamp": "2026-02-10T00:00:00.000Z",
  "requestId": "2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba",
  "data": {
    "success": true,
    "accountId": "20000",
    "cpanelUsername": "xkqjm",
    "forwarder": "[email protected]",
    "destination": [
      "[email protected]"
    ],
    "created": true
  }
}
Request Body Example 1 
{
  "email": "[email protected]",
  "domain": "example.com",
  "destination": "[email protected]"
}