---
title: "Change the account email"
method: PATCH
path: "/v1/me"
tags: ["Accounts"]
---

# Change the account email

`PATCH /v1/me`

## Request

- Base URL: `https://api.cadencercs.com`
- URL: `https://api.cadencercs.com/v1/me`
- Auth: HTTP bearer

**Two steps if the current address is verified, one if it is not**, and that asymmetry is the design. Moving an account's email is how a stolen session becomes a stolen account, so a verified address has to approve before the new one is even offered a link. An address that was never verified has no established owner to ask — demanding proof from it would only block the person it is meant to protect, which is exactly the person who mistyped it or let an agent invent it.

This is the account email: who we bill and notify. It is **not** what carriers see — that is `brand.contact_email` and `agent.contact_email`, and Google emails the latter a mandatory authorisation request during launch review.

## Request body

- object
  - `email` string, required: The new address.

## Response `200`

A link is on its way. Which link depends on whether the current address is verified.

- object
  - `ok` boolean, required
  - `stage` 'awaiting_approval' | 'awaiting_confirmation', required
  - `pendingEmail` string, required
  - `message` string
  - `note` string
  - `emailConfigured` boolean
  - `delivered` boolean
  - `approveLink` string: Only when no mailer is configured, so a deployment with email never returns a credential.
  - `confirmLink` string: Only when no mailer is configured.

## Other responses

- `400`: Malformed address, or a field this route does not edit.
- `401`: Not signed in, and no account-linked API key was sent.
- `409`: Already this account's address, or another account holds it.
- `429`: Rate limited.
- `500`: Unexpected server error. The body is always JSON.

---

[API](https://skmtc.dev/cadencercs/apis/cadence-api.md) · [All operations](https://skmtc.dev/cadencercs/apis/cadence-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cadencercs/apis/cadence-api/revisions/9438443c2081?raw)