Skip to content
justcrawl.io

Verify email address using a verification token

POST
/api/v1/auth/verify-email
Code sample: cURL 
curl -X POST 'https://dashboard.justcrawl.io/api/v1/auth/verify-email' \
  -H 'Content-Type: application/json' \
  -d '{"token":"<verification-token-from-email>"}'

Completes the email-verification flow. The token is single-use and has a 24-hour TTL. On success the user’s emailVerifiedAt timestamp is set and all pending verification tokens for this user are invalidated. The endpoint is idempotent: calling with a valid token on an already-verified account returns 200 with the “already verified” message instead of an error. Email verification unlocks the write-heavy operations (CSV upload, schedule create / trigger).

Request Body required

Section titled “Request Body required ”
Media type application/json
object
token
required
string
Example generated
{
  "token": "example"
}

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Email verified (or already verified).

Media type application/json
object
message
string
Example generated
{
  "message": "example"
}

400

Section titled “400 ”

Validation failed — request body or query is missing/invalid

Media type application/json
object
error
string
Example 
{
  "error": "Missing or invalid \"url\" field"
}

500

Section titled “500 ”

Unexpected server error. Logs and PostHog $exception capture

Media type application/json
object
error
string
Example 
{
  "error": "Something went wrong"
}