Verify an email address for notifications with a code

Verify an email address used for receiving notifications from your services. You need to provide the verification code sent to the email address to complete the process.

Domain Services Email

Context

Related endpoints

PUT /api/email-endpoints/{id} Update settings for an email endpoint GET /api/email-endpoints Get email notification settings POST /api/email-endpoints Create an email notification endpoint

Path Parameters

id integer · min: 1 required Example: 21

Unique id identifier

Headers

Accept Example

Content-Type Example

Body

required

application/json

code string required · Example: 667949

Responses

200

data object required

data.message string required · Example: Email address verified successfully

Human-readable message.

data.verified boolean required · Example: true

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/{id}/verify

For AI assistants

cURL

curl -X POST "https://cloud.hostup.se/api/email-endpoints/21/verify" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "code": "667949"
  }'

Response

{
  "success": true,
  "timestamp": "2026-02-10T00:00:00.000Z",
  "requestId": "2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba",
  "data": {
    "verified": true,
    "message": "Email address verified successfully"
  }
}

{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "message": {
          "type": "string",
          "description": "Human-readable message."
        },
        "verified": {
          "type": "boolean"
        }
      }
    },
    "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 Example 1

{
  "code": "667949"
}