## POST /api/v2/me/email-deliverability/actions/send-test

**Send a test email to the account address**

Self-serve check that email from Hostup reaches the account's primary address. When the address is blocked at our email provider because of an earlier hard bounce, the explicit request clears that block first (an address reported as spam is never cleared this way — change the address instead). A short test email is then sent; poll GET /api/v2/me/email-deliverability to see `lastTest.delivered` flip to true/false. One test per address per 10 minutes. The request body is empty.

### Related Endpoints

- `GET /api/v2/me/email-deliverability`: Get account email deliverability
- `GET /api/v2/me`: Get current account profile
- `PATCH /api/v2/me`: Update current account profile

### Headers

- `Accept`: application/json
- `Authorization`: Bearer YOUR_API_KEY
- Required API scope: `write:account`

### Request Example

```bash
curl -X POST "https://cloud.hostup.se/api/v2/me/email-deliverability/actions/send-test" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"
```

### Response Schema

- `test` (object, required)
- `test.queuedAt` (string, required)
- `test.suppressionLifted` (boolean, required)
- `deliverability` (object, required): Same shape as GET /api/v2/me/email-deliverability.

### Responses

#### 200 - Test email queued.
```json
{
  "test": {
    "queuedAt": "2026-08-21T12:30:00.000Z",
    "suppressionLifted": true
  },
  "deliverability": {
    "email": "info@example.se",
    "status": "suppressed",
    "reason": "Email to info@example.se is currently blocked by our email provider because an earlier message bounced (last on 2026-08-21). Nothing we send — invoices, renewal warnings, ticket replies — reaches this address until it is cleared. Send a test email to clear the block and check the inbox, or change the account email.",
    "lastBounceAt": "2026-08-21T08:35:49.000Z",
    "lastBounceKind": "suppression",
    "lastDeliveredAt": null,
    "lastTest": {
      "sentAt": "2026-08-21T12:30:00.000Z",
      "delivered": null
    },
    "uiShouldShow": true,
    "actions": {
      "canSendTest": {
        "allowed": true,
        "reason": null
      },
      "canChangeEmail": {
        "allowed": true,
        "reason": null
      }
    }
  }
}
```

#### 400 - Invalid request. The response body is an RFC 7807 Problem Details document.
```json
{
  "type": "https://developer.hostup.se/errors/invalid_request",
  "title": "Invalid request",
  "status": 400,
  "detail": "The request body failed validation.",
  "code": "invalid_request",
  "instance": "/api/v2/resource",
  "requestId": "req_01hxa3b4c5d6e7f8g9h0j1k2m3",
  "timestamp": "2026-04-27T12:34:56.000Z",
  "errors": [
    {
      "pointer": "/items/0/domainName",
      "detail": "`domainName` is required.",
      "code": "invalid_request"
    }
  ]
}
```

#### 401 - Authentication required (Problem Details).

#### 403 - Forbidden. The caller lacks a required scope or does not own the resource.
```json
{
  "type": "https://developer.hostup.se/errors/forbidden",
  "title": "Forbidden",
  "status": 403,
  "detail": "The caller lacks a required scope or does not own the resource.",
  "code": "forbidden",
  "instance": "/api/v2/resource",
  "requestId": "req_01hxa3b4c5d6e7f8g9h0j1k2m3",
  "timestamp": "2026-04-27T12:34:56.000Z"
}
```

#### 404 - Not found. The resource does not exist or is not owned by the caller.
```json
{
  "type": "https://developer.hostup.se/errors/not_found",
  "title": "Not found",
  "status": 404,
  "detail": "The requested resource could not be found.",
  "code": "not_found",
  "instance": "/api/v2/resource",
  "requestId": "req_01hxa3b4c5d6e7f8g9h0j1k2m3",
  "timestamp": "2026-04-27T12:34:56.000Z"
}
```

#### 409 - Not allowed for this address — for example mail from us was reported as spam (Problem Details, code `not_allowed`).

#### 429 - A test was already sent within the last 10 minutes (Problem Details, code `rate_limited`, extension `retryAfterSeconds`).

#### 500 - Internal error. Retry later or contact support if the issue persists.
```json
{
  "type": "https://developer.hostup.se/errors/internal_error",
  "title": "Internal server error",
  "status": 500,
  "detail": "An unexpected error occurred. Retry later or contact support if the issue persists.",
  "code": "internal_error",
  "instance": "/api/v2/resource",
  "requestId": "req_01hxa3b4c5d6e7f8g9h0j1k2m3",
  "timestamp": "2026-04-27T12:34:56.000Z"
}
```

#### 502 - The email provider did not accept the test email (Problem Details, code `send_failed`).

#### 503 - The account email could not be loaded (Problem Details, code `upstream_unavailable`).