link_invalid: The emailed link is unknown, used or expired
A sign-up or sign-in link works once and expires after one hour. This one was already used, has expired, or was never issued here. Nothing was created.
What to do
- Request a new link: sign up again (
POST /signup) or sign in (POST /login, or Email me a sign-in link on the dashboard). - If the message says the address is already verified, sign in instead of signing up.
- Some email security scanners open links before you do; if links arrive already used, ask your mail administrator to exempt the deployment's address.
On the wire
HTTP 400, error type invalid_request_error, param is token. Only the multi-tenant front door answers this code (GET /signup/verify and GET /login/verify), always as JSON with errorDetail, even when the link is opened in a browser. The message is "this verification link is unknown, used or expired" or "this address is already verified; sign in instead" for a sign-up link, and "this sign-in link is unknown, used or expired" for a sign-in link.
{
"error": "link_invalid",
"errorDetail": {
"type": "invalid_request_error",
"code": "link_invalid",
"message": "this sign-in link is unknown, used or expired",
"param": "token",
"doc_url": "…/errors/link_invalid.md",
"fix": "the link is unknown, used or expired; request a new one"
}
}
See all error codes.