GET /auth/verify-email
Verify a user’s email address using the token sent in the verification email. Typically the user clicks a link that opens this endpoint with the token in the query string.
Endpoint
GET /api/v1/public/projects/:projectSlug/auth/verify-email?token=<verification_token>Request Parameters
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
projectSlug | string | ✅ | Your project’s unique slug |
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
token | string | ✅ | Verification token from the email link |
Example
After the user signs up, they receive an email with a link like:
https://api.aerocall.app/api/v1/public/projects/your-project/auth/verify-email?token=abc123...When the user opens that link (GET request), the backend marks their email as verified. You can then allow full access or redirect them to your app.
Response
Success (200 OK)
Typically returns a simple success payload or redirect. Exact shape depends on your project configuration.
Error Responses
| Status Code | Error Code | Description |
|---|---|---|
| 400 | INVALID_TOKEN | Token is invalid or expired |
| 404 | TOKEN_NOT_FOUND | Token not found |
| 500 | INTERNAL_SERVER_ERROR | Server error |
Available Hooks
- Event:
auth.email.verified- When: After email is successfully verified
- Can do: Send additional onboarding emails, grant access in external systems
Configure in Project → Hooks. Learn more about hooks →
Related Endpoints
- POST /auth/resend-verification - Resend verification email
- POST /auth/register - Sign up (may require verification)