Skip to content
HostupDevelopers
GuidesAPI referenceSupport

Close the account e-mail notice

POST /api/v2/me/email-deliverability/actions/dismiss

Close the client-area notice about the account e-mail address for good. Only a mailbox_moved notice can be closed. That notice is information only, because mail still arrives.

Check actions.canDismiss.allowed on GET /api/v2/me/email-deliverability first. Any other status returns 409 not_allowed with the reason in detail. Send no body. The response is the delivery status after the change, the same as the GET.

Authentication: An API key with the scope write:account. About keys and scopes

Example

POST /api/v2/me/email-deliverability/actions/dismiss
curl -X POST "https://cloud.hostup.se/api/v2/me/email-deliverability/actions/dismiss" \
  -H "Authorization: Bearer $HOSTUP_API_KEY" \
  -H "Content-Type: application/json"

Responses

200 Notice closed. The body is the delivery status, the same as GET /api/v2/me/email-deliverability.

Response 200
{
  "email": "[email protected]",
  "status": "ok",
  "reason": null,
  "lastBounceAt": null,
  "lastBounceKind": null,
  "lastDeliveredAt": "2026-10-28T09:12:40.000Z",
  "lastTest": null,
  "uiShouldShow": false,
  "domainNotice": null,
  "actions": {
    "canSendTest": {
      "allowed": true,
      "reason": null
    },
    "canChangeEmail": {
      "allowed": true,
      "reason": null
    },
    "canDismiss": {
      "allowed": false,
      "reason": "There is no notice to close."
    }
  }
}
Response fields
emailstring
The account e-mail address.
statusstring
Delivery status. GET /api/v2/me/email-deliverability explains each value. One of ok, transient, undeliverable, suppressed, complaint, mailbox_moved, mail_lost, unknown.
reasonstring or null
What is wrong and what to do. null when nothing needs attention.
lastBounceAtstring or null
When the last bounce or spam report was recorded.
lastBounceKindstring or null
Kind of the last bounce: permanent, transient, suppression (blocked for sending) or complaint (spam report). One of permanent, transient, suppression, complaint.
lastDeliveredAtstring or null
When a message last reached the address.
lastTestobject or null
The last test e-mail. null when none was sent.
uiShouldShowboolean
true when the client area shows a warning about the address.
actionsobject
What the caller can do now. Each gate has allowed and a reason when it is not allowed.
canSendTestobject
Whether POST /api/v2/me/email-deliverability/actions/send-test is allowed.
allowedboolean
reasonstring or null
canChangeEmailobject
Whether the account e-mail can be changed.
allowedboolean
reasonstring or null
canDismissobject
Whether POST /api/v2/me/email-deliverability/actions/dismiss is allowed.
allowedboolean
reasonstring or null
domainNoticeobject or null
Set for mailbox_moved and mail_lost. Otherwise null.

Errors

Errors are Problem Details with a stable code. Branch on the code, not on the text.

400Invalid request. The response body is an RFC 7807 Problem Details document.
401Authentication is required.
403Forbidden. The caller lacks a required scope or does not own the resource.
404Not found. The resource does not exist or is not owned by the caller.
409There is nothing that can be closed now (not_allowed). detail says why.
429Rate limited. Retry after the limit resets. 429 responses include Retry-After seconds plus X-RateLimit-* headers.
500Internal error. Retry later or contact support if the issue persists.
503The account e-mail address could not be loaded right now (upstream_unavailable). Try again shortly.

This page as MarkdownOpenAPI spec