---
"@context": https://schema.org
"@type": TechArticle
"@id": https://www.twilio.com/docs/api/errors/25012#article
headline: "25012: Updating the email address is unsupported"
url: https://www.twilio.com/docs/api/errors/25012
inLanguage: en
dateModified: 2026-06-08T11:38:30.000Z
author:
  "@type": Organization
  name: Twilio Developer Education Team
publisher:
  "@type": Organization
  name: Twilio
---

# 25012: Updating the email address is unsupported

Log Type: APPLICATION

Log Level: ERROR

## Description

This error occurs when your request tries to change a managed user's primary email in a way that Twilio does not accept. For organization-managed users, the primary email and `userName` represent the same sign-in identity, and email changes must stay aligned with your organization's verified domains.

### Possible causes

* Your SCIM `PUT` or `PATCH` request attempts to change the primary email without preserving the required relationship between the primary email and `userName`.
* The value in `emails[primary=true].value` does not match `userName`. Twilio rejects mismatched identity values for managed users.
* The new email address uses a domain that your organization has not verified.

### Possible solutions

* Retry the update by using `PUT /scim/v2/Users/{id}` or `PATCH /scim/v2/Users/{id}` and keep `emails[primary=true].value` and `userName` set to the same value.
* If you are changing the email in Console instead of through SCIM, update it from User Settings and complete the email verification step. After the change, the new email is also the username used to sign in. ([help.twilio.com](https://help.twilio.com/articles/223135787-How-can-I-change-my-email-address-))
* Verify the target email domain on your organization before you retry the request. Twilio only allows managed-user email addresses from verified domains.
* If you do not need to change the user's sign-in identity, leave the email unchanged and update only supported profile fields such as `displayName`, `name.givenName`, `name.familyName`, `locale`, `timezone`, or `active`.

#### Additional resources

* [SCIM API reference](/docs/iam/scim/api-reference)
* [Managed users](/docs/iam/organizations/managed-users)
* [Domains](/docs/iam/organizations/domains)