invalid_email_token

HTTP status: 401 · Code: invalid_email_token

The email link’s token is unknown, already used, expired, or replaced by a newer email.

Why it happens

The token from an email link is unknown, already used, expired, or replaced by a newer email.

How to fix

Ask the person to request a new email and use the link in the newest one. Each link works once.

Catch it in your code

Every SDK throws one error type for a failed call. Match on its code, which is always invalid_email_token for this error, never on the message.

JavaScript and Next.js

import { ErrorCode, OrvanoError } from '@orvano/js'

try {
  // your Orvano call
} catch (error) {
  if (error instanceof OrvanoError && error.code === ErrorCode.invalidEmailToken) {
    // handle invalid_email_token
  } else {
    throw error
  }
}

Dart and Flutter

import 'package:orvano_flutter/orvano_flutter.dart'; // or orvano_dart on a server

try {
  // your Orvano call
} on OrvanoException catch (error) {
  if (error.code != ErrorCode.invalidEmailToken) rethrow;
  // handle invalid_email_token
}

.NET

using Orvano;

try
{
    // your Orvano call
}
catch (OrvanoException error) when (error.Code == ErrorCode.InvalidEmailToken)
{
    // handle invalid_email_token
}

The error also carries the HTTP status (401), a message, and a request ID. Quote the request ID when you report a problem: the server logs it with the failure. See Errors for how errors work in every SDK, or every error code.