Verify email with token

POST https://app.speybooks.com/api/v1/email-verification/verify-email

Verify an email address using the token from the verification link. Public endpoint (no auth required) so the link works from any device. Atomically updates the user record and marks the token as used. Idempotent — returns success if already verified.

Body parameters

token string required

The 64-character verification token from the email link.

Response

200 Email verified successfully, or was already verified.

Show response fields

message string

Human-readable result message.

Error codes

400 Invalid, expired, or already-used verification token.

Request POST /v1/email-verification/verify-email curl

curl -X POST https://api.speybooks.com/v1/auth/verify-email \
  -H "Content-Type: application/json" \
  -d '{"token": "a1b2c3..."}'

Response 200

{
  "success": true,
  "message": "Email verified successfully!"
}