Create an email notification endpoint

Configure an email address to receive notifications from HostUp, such as monitoring alerts or other important messages related to your account or specific services.

Domain Services Email

Context

Used in the dashboard

/notifications

Headers

Accept Example
Content-Type Example

Body

required
application/json
email string required · Example: [email protected]
name string required · Example: Anna Svensson
scope string · enum required · Example: vm_monitor
all
vm_monitor

Responses

200
data object required
data.email_endpoint object required
data.email_endpoint.auto_paused boolean required · Example: false
data.email_endpoint.auto_paused_at string · nullable required · Example: null

Nullable: may be null when not applicable.

data.email_endpoint.auto_paused_reason string · nullable required · Example: null

Nullable: may be null when not applicable.

data.email_endpoint.auto_resume_available_at string · nullable required · Example: null

Nullable: may be null when not applicable.

data.email_endpoint.channel_type string required · Example: email
data.email_endpoint.client_id string required · Example: 30000
data.email_endpoint.config object required
data.email_endpoint.config.address string required · Example: Examplegatan 1
data.email_endpoint.config.verified boolean required · Example: false
data.email_endpoint.created_at string required · Example: 2026-02-10T00:00:00.000Z
data.email_endpoint.enabled boolean required · Example: true
data.email_endpoint.id integer required · Example: 72
data.email_endpoint.last_used_at string · nullable required · Example: null

Nullable: may be null when not applicable.

data.email_endpoint.monitor_id string · nullable required · Example: null

Nullable: may be null when not applicable.

data.email_endpoint.name string required · Example: Anna Svensson
data.email_endpoint.scope string · enum required · Example: vm_monitor
all
vm_monitor
data.email_endpoint.updated_at string required · Example: 2026-02-10T00:00:00.000Z
data.message string required · Example: Email endpoint created successfully

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

POST https://cloud.hostup.se/api/email-endpoints
For AI assistants
cURL 
curl -X POST "https://cloud.hostup.se/api/email-endpoints" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Anna Svensson",
    "email": "[email protected]",
    "scope": "vm_monitor"
  }'
Response 
{
  "success": true,
  "timestamp": "2026-02-10T00:00:00.000Z",
  "requestId": "2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba",
  "data": {
    "email_endpoint": {
      "id": 72,
      "client_id": "30000",
      "channel_type": "email",
      "scope": "vm_monitor",
      "monitor_id": null,
      "name": "Anna Svensson",
      "enabled": true,
      "config": {
        "address": "Examplegatan 1",
        "verified": false
      },
      "created_at": "2026-02-10T00:00:00.000Z",
      "updated_at": "2026-02-10T00:00:00.000Z",
      "last_used_at": null,
      "auto_paused": false,
      "auto_paused_reason": null,
      "auto_paused_at": null,
      "auto_resume_available_at": null
    },
    "message": "Email endpoint created successfully"
  }
}
Request Body Example 1 
{
  "name": "Anna Svensson",
  "email": "[email protected]",
  "scope": "vm_monitor"
}