# Verification Message Template

Learn when FusionAuth sends the message that verifies a user's phone number, 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 to verify a phone number: after a user registers or changes a phone number, when you call the [Identity Verify](https://fusionauth.io/docs/apis/identity-verify.md) API, and for [identity pre-verification](https://fusionauth.io/docs/users/verify/identity-pre-verification-using-phone.md). Assign the template in **Verification template** on the Tenants -> Your Tenant -> Identities tab. To override the template for one Application, set **Verification template** on the Applications -> Your Application -> Identities tab.

## Default Template

FusionAuth ships the following default template:

```ftl
[#-- When a one-time code is provided, you will want the user to enter this value interactively using a form. In this workflow the verificationId
     is not shown to the user and instead the one-time code must be paired with the verificationId which is usually in a hidden form field. When the two
     values are presented together, the phone number can be verified --]
[#if verificationOneTimeCode??]
Verification code: ${verificationOneTimeCode}
[#else]
To complete your phone number verification click on the following link.

${baseUrl}/phone/verify/${verificationId}?client_id=${(application.oauthConfiguration.clientId)!''}&tenantId=${tenant.id}
[/#if]

- 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`.

`phoneNumber`

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

The phone number to verify. The [Generic messenger](https://fusionauth.io/docs/messengers/generic-messenger.md) request has the same value in **`phoneNumber`**.

`state`

*   Type: `Object`

The **`state`** from the verification request. The variable is present only when the request includes **`state`**.

`tenant`

*   Type: `Tenant`

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

`verificationId`

*   Type: `String`

The verification Id for the [Identity Verify](https://fusionauth.io/docs/apis/identity-verify.md) API.

`verificationOneTimeCode`

*   Type: `String`

The one-time code for the `FormField` verification strategy. The user enters the code to verify the phone number.

The template receives no **`user`**, because FusionAuth can send the message before the user exists, during identity pre-verification. Use **`phoneNumber`** to refer to the recipient.

Related

[Email Passwordless Login Email Template Learn when FusionAuth sends the passwordless login email, and which variables the template receives. one-time codefreemarker](https://fusionauth.io/docs/email/template-reference/account/passwordless-login.md)

[Messengers Passwordless Login Message Template Learn when FusionAuth sends the passwordless login message, and which variables the template receives. one-time codefreemarker](https://fusionauth.io/docs/messengers/template-reference/account/passwordless-login.md)

[Messengers Verification Complete Message Template Learn when FusionAuth sends the message that confirms a verified phone number, and which variables the template receives. identity verificationfreemarker](https://fusionauth.io/docs/messengers/template-reference/account/verification-complete.md)

[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)
---

## Other pages in Account

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

- [Forgot Password Message Template](https://fusionauth.io/docs/messengers/template-reference/account/forgot-password.md): Learn when FusionAuth sends the forgot password message, and which variables the template receives.
- [Passwordless Login Message Template](https://fusionauth.io/docs/messengers/template-reference/account/passwordless-login.md): Learn when FusionAuth sends the passwordless login message, and which variables the template receives.
- [Set Up Password Message Template](https://fusionauth.io/docs/messengers/template-reference/account/set-up-password.md): Learn when FusionAuth sends the message that asks a new user to set a password, and which variables the template receives.
- [Verification Complete Message Template](https://fusionauth.io/docs/messengers/template-reference/account/verification-complete.md): Learn when FusionAuth sends the message that confirms a verified phone number, and which variables the template receives.
