---
title: "Update User Email"
method: PATCH
path: "/v1/users/{user_id}"
tags: ["User"]
---

# Update User Email

`PATCH /v1/users/{user_id}`

> 📘
>
> You can place the bearer `access_token` for a specific user into the Authentication section of this documentation 👉.

> 🚧
>
> Note that a `user_updated` [webhook](https://docs.astra.finance/reference/user-webhooks#user-updated) will fire upon successful email update for a given User.

> 🚧
>
> Upon the third email change within a rolling 365 day window, the User's capabilities will be automatically downgraded.  Details on User Capabilities [here](https://knowledge.astrafi.com/articles/4866933514-user-capabilities)

## Path parameters

- `user_id` string, required

## Request body

- object
  - `email` string, required — The new email address for the User. Must be a valid email format.

## Response `200`

Successful response

- object
  - `id` string — Unique Astra user ID
  - `email` string — Email address of the user
  - `phone` string — Phone number of the user
  - `first_name` string — First name of the user
  - `last_name` string — Last name of the user
  - `preferred_first_name` string — Preferred first name of the user
  - `preferred_last_name` string — Preferred last name of the user
  - `preferred_pronouns` string — Preferred pronouns of the user
  - `status` 'approved' | 'pending' | 'retry' | 'document' | 'suspended' | 'rejected' — Current status of the user (Details on [User Statuses](https://docs.astra.finance/reference/user-statuses))
  - `rejection_reasons` unknown[] — List of details on why a User is not approved
    - unknown
  - `kyc_type` 'receive-only' | 'unverified' | 'verified' — The verification type of the user, which determines the user's capabilities to send and/or receive funds
  - `metadata` object — An optional metadata object for submitting custom data (during User Intent creation) that will be associated with the User Intent and the User
    - `custom_field_name_1` string — Supply a custom name for any number of fields, and provide it a custom value
    - `custom_field_name_2` string — Supply a custom name for any number of fields, and provide it a custom value

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `422` — Unprocessable Content

---

[API](https://skmtc.net/astra/apis/astra-developer-api.md) · [All operations](https://skmtc.net/astra/apis/astra-developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/astra/astra-developer-api/versions/09f0430e5d33/schema)