Manage your domain's email catch-all rules

Enable or disable catch-all rules for your domain. A catch-all rule forwards emails not addressed to a specific recipient to a designated address or discards them.

Domain Services Email

Context

Related endpoints

GET /api/email-forwarding Get and display email forwarding settings POST /api/email-forwarding Create and manage email forwarding for your domain DELETE /api/email-forwarding Delete an email forwarding rule for a domain

Headers

Accept Example

Content-Type Example

Body

required

application/json

action string · enum required · Example: disable

disable

forward

destination string · Example: [email protected]

domain string required · Example: example.com

Responses

200

data object required

data.catchAll object required

data.catchAll.actionType string · enum required · Example: drop

drop

forward

data.catchAll.destination string · nullable required · Example: [email protected]

Nullable: may be null when not applicable.

data.catchAll.enabled boolean required · Example: false

data.catchAll.id string required · Example: 4084769a40ca4f5ebca27596096be8c1

data.catchAll.name string required · Example: Catch-all

data.catchAll.tag string required · Example: catch-all

data.message string required · Example: Catch-all rule disabled

Human-readable message.

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).

400

No response body

PUT https://cloud.hostup.se/api/email-forwarding/catch-all

For AI assistants

cURL

curl -X PUT "https://cloud.hostup.se/api/email-forwarding/catch-all" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "example.com",
    "action": "disable"
  }'

Response

{
  "success": true,
  "timestamp": "2026-02-10T00:00:00.000Z",
  "requestId": "2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba",
  "data": {
    "message": "Catch-all rule disabled",
    "catchAll": {
      "id": "4084769a40ca4f5ebca27596096be8c1",
      "enabled": false,
      "name": "Catch-all",
      "actionType": "drop",
      "destination": null,
      "tag": "catch-all"
    }
  }
}

{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "catchAll": {
          "type": "object",
          "properties": {
            "actionType": {
              "type": "string",
              "enum": [
                "drop",
                "forward"
              ]
            },
            "destination": {
              "type": "string",
              "nullable": true
            },
            "enabled": {
              "type": "boolean"
            },
            "id": {
              "type": "string"
            },
            "name": {
              "type": "string"
            },
            "tag": {
              "type": "string"
            }
          }
        },
        "message": {
          "type": "string",
          "description": "Human-readable message."
        }
      }
    },
    "requestId": {
      "type": "string",
      "description": "Unique request identifier (UUID)."
    },
    "success": {
      "type": "boolean",
      "description": "True for successful responses."
    },
    "timestamp": {
      "type": "string",
      "description": "ISO 8601 timestamp (UTC)."
    }
  }
}

Request Body disable

{
  "domain": "example.com",
  "action": "disable"
}