# Identity Update Message Template

Learn when FusionAuth sends the message that tells a user their phone number changed, and which variables the template receives.

> For the index of this section of the site, see [llms.txt](https://fusionauth.io/docs/llms.txt)

FusionAuth sends this message when a user's phone number changes. FusionAuth sends the message to the previous phone number, then to the new phone number. When the change removes the phone number, only the previous phone number gets the message. Assign the template in **Identity update** on the Tenants -> Your Tenant -> Identities tab. To override the template for one Application, set the template on the Applications -> Your Application -> Identities tab.

## Example Template

FusionAuth ships no default for this template. Start from the following example:

```ftl
[#-- FusionAuth sends this message to the previous phone number and to the new one --]
[#if (event.previousLoginId)?? && (event.newLoginId)??]
The phone number for your account changed from ${event.previousLoginId} to ${event.newLoginId}.
[#elseif (event.previousLoginId)??]
The phone number ${event.previousLoginId} was removed from your account.
[#else]
The phone number for your account changed.
[/#if]
If you didn't make this change, contact support right away.

- FusionAuth Admin
```

## Replacement Variables

`application`

*   Type: `Application`

The Application object. For field definitions, see the [Application API](https://fusionauth.io/docs/apis/applications.md).

The variable is present only when the request that sends the message identifies an Application. Check for the variable before you use it:

```ftl
[#if application??]
  ${application.name}
[/#if]
```

`baseUrl`

*   Type: `String`
*   Available since `1.68.0`

The base URL for links in the message. FusionAuth uses the Application **baseURL**, then the Tenant **baseURL**, then `http://localhost:9011`.

`event`

*   Type: `Object`

The User Identity Update event. The previous phone number is in **`event.previousLoginId`**, and the new phone number is in **`event.newLoginId`**. For field definitions, see the [User Identity Update](https://fusionauth.io/docs/events/reference/user/user-identity-update.md) event reference.

`phoneNumber`

*   Type: `String`
*   Available since `1.59.0`

The phone number FusionAuth sends the message to: the previous phone number in the first message, and the new phone number in the second. The [Generic messenger](https://fusionauth.io/docs/messengers/generic-messenger.md) request has the same value in **`phoneNumber`**.

`tenant`

*   Type: `Tenant`

The Tenant object. For field definitions, see the [Tenant API](https://fusionauth.io/docs/apis/tenants.md).

`user`

*   Type: `User`

The User object for the recipient. For field definitions, see the [User API](https://fusionauth.io/docs/apis/users.md).

Related

[APIs Create an Email Template API API documentation for the FusionAuth Create an Email Template API. freemarker](https://fusionauth.io/docs/apis/emails/create-an-email-template.md)

[APIs Email API Learn about the APIs for creating, retrieving, updating and deleting email templates as well as sending emails to users. freemarker](https://fusionauth.io/docs/apis/emails.md)

[APIs Preview an Email Template API API documentation for the FusionAuth Preview an Email Template API. freemarker](https://fusionauth.io/docs/apis/emails/preview-an-email-template.md)

[APIs Retrieve an Email Template API API documentation for the FusionAuth Retrieve an Email Template API. freemarker](https://fusionauth.io/docs/apis/emails/retrieve-an-email-template.md)
---

## Other pages in Security

> For the full index of this section, see [Messengers](https://fusionauth.io/docs/llms-messengers.txt).

- [Admin Two-Factor Method Removed Message Template](https://fusionauth.io/docs/messengers/template-reference/security/admin-two-factor-method-removed.md): Learn when FusionAuth sends the message that tells a user an administrator removed a two-factor method, and which variables the template receives.
- [Login Id Duplicate on Create Message Template](https://fusionauth.io/docs/messengers/template-reference/security/login-id-duplicate-on-create.md): Learn when FusionAuth sends the message that tells a user someone tried to sign up with their login Id, and which variables the template receives.
- [Login Id Duplicate on Update Message Template](https://fusionauth.io/docs/messengers/template-reference/security/login-id-duplicate-on-update.md): Learn when FusionAuth sends the message that tells a user another account tried to take their login Id, and which variables the template receives.
- [Password Reset Success Message Template](https://fusionauth.io/docs/messengers/template-reference/security/password-reset-success.md): Learn when FusionAuth sends the message that confirms a password reset, and which variables the template receives.
- [Password Update Message Template](https://fusionauth.io/docs/messengers/template-reference/security/password-update.md): Learn when FusionAuth sends the message that tells a user their password changed, and which variables the template receives.
- [Threat Detected Message Template](https://fusionauth.io/docs/messengers/template-reference/security/threat-detected.md): Learn when FusionAuth sends the message about a new device or suspicious login, and which variables the template receives.
- [Two-Factor Authentication Message Template](https://fusionauth.io/docs/messengers/template-reference/security/two-factor-authentication.md): Learn when FusionAuth sends the message with a multi-factor code, and which variables the template receives.
- [Two-Factor Method Added Message Template](https://fusionauth.io/docs/messengers/template-reference/security/two-factor-method-added.md): Learn when FusionAuth sends the message that tells a user a two-factor method was added, and which variables the template receives.
- [Two-Factor Method Removed Message Template](https://fusionauth.io/docs/messengers/template-reference/security/two-factor-method-removed.md): Learn when FusionAuth sends the message that tells a user a two-factor method was removed, and which variables the template receives.
