> ## Documentation Index
> Fetch the complete documentation index at: https://docs.particle.pro/llms.txt
> Use this file to discover all available pages before exploring further.

# email_verification_required

> Email verification is required to complete registration

|                    |                               |
| ------------------ | ----------------------------- |
| **HTTP status**    | `200 OK`                      |
| **Error code**     | `email_verification_required` |
| **Resolve action** | `verify_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. **Alert notifications** — an alert was created or updated with a notification email that has not been verified for the owning organization. The alert write is rejected so that no alert silently fails to deliver.

## How to fix

### Account signup

<Steps>
  <Step>
    Check your inbox for an email with the subject "Verify your email address".
  </Step>

  <Step>
    Click the verification link in the email. The link expires in 24 hours.
  </Step>

  <Step>
    After verification, log in with your credentials.
  </Step>
</Steps>

If you did not receive the email, you can request a new one:

Call `POST /v1/auth/register` again with the same credentials. This will resend the verification email and invalidate any previous verification links.

### Alert notifications

<Steps>
  <Step>
    Start verification for the email address by calling `POST /v1/organizations/{orgId}/notification-emails` with `{"email": "..."}`. A confirmation link is sent to that address.
  </Step>

  <Step>
    Click the link (or `POST /v1/notification-emails/verify` with the token from the link). The link expires in 24 hours.
  </Step>

  <Step>
    Retry the alert `POST` or `PATCH` — the email is now in the organization's verified pool and the write succeeds.
  </Step>
</Steps>

Alert 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.