Email

Email destinations send alerts to a single address. They must be verified before they receive anything.

Add an email destination

Open Destinations

Click Destinations in the sidebar, then Add Destination, then choose Email.

Fill in the details

Field	Required	Description
Name	Yes	A label for the destination, up to 255 characters.
Email address	Yes	A valid address, up to 255 characters.

Choose events

Toggle which events this address receives. All are enabled by default; at least one must stay enabled. See Events.

Verify the address

Unless the address already belongs to an active member of your organization, UptimeIO emails a 12-character verification code. Enter it next to the pending destination on the Destinations page.

Assign it to monitors

Select the destination in each monitor’s Notifications section.

Verification

Addresses of active organization members are verified automatically.
Other addresses get a 12-character hexadecimal code. The code expires after 24 hours.
Use Resend Code if it does not arrive. The dashboard enforces a 30-second wait between resends, and resending is limited to 3 requests per hour per destination.
A destination that is not verified does not receive alerts.

Test the destination

Use Test on the destination to send a test email. Each destination can send 3 test emails per day.

What an email contains

The subject names the event and the monitor, for example [UptimeIO] Monitor Down: API Server. The body includes the monitor name and URL, when it started, the error details and a link to the incident.

Events

Event	Preference key
Monitor goes down	`on_failure`
Monitor recovers	`on_recovery`
SSL certificate warnings	`on_ssl_expiry`
Domain expiry warnings	`on_domain_expiry`
Response time exceeds threshold	`on_slow_response`
Response time returns to normal	`on_slow_response_resolved`

Create an email destination with the API

The dashboard uses POST /api/integrations. Authenticate with a session token; see Authentication.

{
  "type": "EMAIL",
  "name": "Team email",
  "configuration": { "email": "[email protected]" },
  "events": {
    "on_failure": true,
    "on_recovery": true,
    "on_ssl_expiry": true,
    "on_domain_expiry": true,
    "on_slow_response": true,
    "on_slow_response_resolved": true
  }
}

Verify with POST /api/integrations/{instanceId}/verify and body { "code": "<12-character code>" }.

Troubleshooting

Issue	Solution
Not receiving emails	Check spam, confirm the destination is verified, assigned to the monitor, and the event is enabled.
Verification email not arriving	Check spam, then use Resend Code.
Wrong events received	Edit the destination and adjust its event toggles.

Getting Started

Monitor Types

Essentials

Notifications

Integrations

Status Pages

Account & Team

Plans & Billing

Add an email destination

Verification

Test the destination

What an email contains

Events

Create an email destination with the API

Troubleshooting

Next steps

Setting Up Alerts

Notifications Overview

​Add an email destination

​Verification

​Test the destination

​What an email contains

​Events

​Create an email destination with the API

​Troubleshooting

​Next steps

Setting Up Alerts

Notifications Overview

Add an email destination

Verification

Test the destination

What an email contains

Events

Create an email destination with the API

Troubleshooting

Next steps