---
title: "Confirm email"
method: POST
path: "/accounts/confirm-email"
tags: ["Account Management"]
---

# Confirm email

`POST /accounts/confirm-email`

## Request

- Base URL: `https://api.quiva.ai`
- URL: `https://api.quiva.ai/accounts/confirm-email`
- Auth: none required
- TypeScript: <https://skmtc.dev/quivaworks/apis/quiva-ai-gateway/docs/accounts/confirm-email/post.ts> (a function with typed inputs; its response is checked against the schema)

Confirms a user's email address using a token or code
 - This process ensures that the person registering or using an email address actually has access to it. When a user registers a new account or adds a new email address to their profile, the system sends a confirmation email containing either a token (a long, randomly generated string) or a numerical code. This function processes the verification when the user clicks the confirmation link in the email or manually enters the provided code. It accepts either:
- a) A token parameter, which is included in the confirmation link
- b) A code parameter, which is a shorter numerical sequence that can be manually entered

## Request body

- union
  - object
    - `token` string, required: Email confirmation token
    - `code` string: Email confirmation code (alternative to token)
  - object
    - `token` string: Email confirmation token
    - `code` string, required: Email confirmation code (alternative to token)

## Response `200`

Email confirmed successfully

- object
  - `data` object, required
    - `account` string
    - `email` string, email
    - `account_id` string
    - `user_id` string

## Other responses

- `400`: Invalid token

## Changes

- **2025-06-12** `4979dfd00eda`: 4 warning, 1 info
  - removed the optional property `account` from the response with the `200` status
  - removed the optional property `account_id` from the response with the `200` status
  - removed the optional property `email` from the response with the `200` status
  - removed the optional property `user_id` from the response with the `200` status
  - …1 more

[Operation history](https://skmtc.dev/quivaworks/apis/quiva-ai-gateway/changes/accounts/confirm-email/post.md)

---

[API](https://skmtc.dev/quivaworks/apis/quiva-ai-gateway.md) - [All operations](https://skmtc.dev/quivaworks/apis/quiva-ai-gateway/llms.txt) - [OpenAPI document](https://skmtc.dev/quivaworks/apis/quiva-ai-gateway/revisions/700eb1ace61a?raw)