Skip to main content
HTTP status200 OK
Error codeemail_verification_required
Resolve actionverify_email

What happened

An email address needs to be verified before it can be used. This error is returned in two contexts:
  1. Account signup — a verification email has been sent to the registering address; the account is not created until the link is clicked.
  2. Monitor notifications — a monitor was created or updated with a notification email that has not been verified for the owning organization. The monitor write is rejected so that no monitor silently fails to deliver.

How to fix

Account signup

1
Check your inbox for an email with the subject “Verify your email address”.
2
Click the verification link in the email. The link expires in 24 hours.
3
After verification, log in with your credentials.
If you did not receive the email, you can request a new one: Try registering again with the same email and password. This will resend the verification email and invalidate any previous verification links.

Monitor notifications

1
Start verification for the email address by calling POST /v1/organizations/{orgId}/notification-emails with {"email": "..."}. A confirmation link is sent to that address.
2
Click the link (or POST /v1/notification-emails/verify with the token from the link). The link expires in 24 hours.
3
Retry the monitor POST or PATCH — the email is now in the organization’s verified pool and the write succeeds.
Monitor notification channels that match the authenticated user’s own email address are auto-verified the first time they are used, so no extra step is needed for self-delivery.