Sets the specified user's email address. Before using this endpoint, you must verify the target domain as the new email address will be considered verified. The permission to make use of this resource is exposed by the email.set privilege. This call invalidates all active sessions.

Forge and OAuth2 apps cannot access this REST resource.

Request

Path parameters

account_id

AccountId

Required

Request bodyapplication/json

An object containing the email address

email

Required

Responses

Everything went fine, nothing to return.

PUT/users/{account_id}/manage/email

curl

Node.js

Java

Python

PHP

curl --request PUT \
  --url 'https://api.atlassian.com/users/{account_id}/manage/email' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "email": "vmars@marsinvestigations.com"
}'