---
title: "Update primary email"
method: POST
path: "/api/my-account/primary-email"
tags: ["My account"]
---

# Update primary email

`POST /api/my-account/primary-email`

Update primary email for the user, a logto-verification-id in header is required for checking sensitive permissions, and a new identifier verification record is required for the new email ownership verification.

## Request body

- object
  - `email` string, regex, required — The new email for the user.
  - `newIdentifierVerificationRecordId` string, required — The identifier verification record ID for the new email ownership verification.

## Response `204`

The primary email was updated successfully.

## Other responses

- `400` — The new verification record is invalid.
- `401` — Unauthorized
- `403` — Permission denied, the application is a third-party application. The Account API only accepts mutations from first-party applications.
- `422` — Unprocessable Content

---

[API](https://skmtc.net/logto/apis/logto-api-references.md) · [All operations](https://skmtc.net/logto/apis/logto-api-references/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/logto/logto-api-references/revisions/0287c6a59eba/schema)
