Verify a magic-link token and land on the app

GET/api/auth/magic-link/verify

Query parameters

tokenstringrequired

callbackURLstring

default: "/"

newUserCallbackURLstring

errorCallbackURLstring

Responses

302

Success redirects to callbackURL (or newUserCallbackURL for first-time users) with the token applied; failures redirect to errorCallbackURL with ?error=. All targets are validated before any redirect is issued.

400

Missing token or an untrusted redirect parameter.

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Parameters

tokenquery*callbackURLquerynewUserCallbackURLqueryerrorCallbackURLquery

Request

curl -X GET 'https://your-deployment.convex.site/api/auth/magic-link/verify?token=string'

const response = await fetch("https://your-deployment.convex.site/api/auth/magic-link/verify?token=string", {
  method: "GET"
});

import requests

response = requests.get(
    "https://your-deployment.convex.site/api/auth/magic-link/verify?token=string",
)

Response

Success redirects to `callbackURL` (or `newUserCallbackURL` for first-time users) with the token applied; failures redirect to `errorCallbackURL` with `?error=`. All targets are validated before any redirect is issued.