> You are reading the Docusign Developer Documentation. For clean Markdown of any page, append .md to the page URL.
>
> Documentation indexes by section:
> - APIs and SDKs: https://docusign.docs.buildwithfern.com/docs/llms.txt
> - Platform 101: https://docusign.docs.buildwithfern.com/platform/llms.txt
> - Extension Apps: https://docusign.docs.buildwithfern.com/extension-apps/llms.txt
> - Docusign CLI: https://docusign.docs.buildwithfern.com/docusign-cli/llms.txt
>
> Authentication (OAuth, JWT Grant, M2M): https://docusign.docs.buildwithfern.com/platform/auth
> Webhooks and Connect: https://docusign.docs.buildwithfern.com/platform/webhooks
>
> OpenAPI specifications: https://docusign.docs.buildwithfern.com/openapi.json
> MCP server: https://docusign.docs.buildwithfern.com/_mcp/server

# Email address verification extension contract reference

> Learn how to implement the email address verification extension.

This extension enables real-time verification of an email address. Your extension app must perform validation itself or call an external service that verifies the existence and deliverability of email addresses.

> **Note**
>
> This extension verifies specific types of values. See [Connected fields extension overview](/extension-apps/extension-apps-101/supported-extensions/connected-fields) for information about an extension that can verify any type of value against an organization’s system of record.

You can include this extension when you [register an extension app](/extension-apps/build-an-extension-app/register). If you register the extension app [using a form](/extension-apps/build-an-extension-app/register/use-form), select the **Data Verification** extension in the form-based UI. Then select a verification type of **Email**.

![Email address verification extension in form-based registration](/_fern-files/_img/b7f56c6ded178023687defebff57a774a268c78dbe77617f3284aa65cf0c713c.webp)

If you register the extension app [using an app manifest file](/extension-apps/build-an-extension-app/register/use-manifest), set the `extensions.template` value in your app manifest to `Verify.Version2.Email`.

This extension has one action. The action name you specify when you register an extension app depends on whether you register the app using a form or using an app manifest file. The app manifest file value listed here appears in the `actions.template` property.

| Form-Based Action Name | App Manifest File Value |
| ---------------------- | ----------------------- |
| Verify Email           | `Verify.Version2.Email` |

You provide the details required for action execution when you register an extension app. See [Update extension and action settings](/extension-apps/build-an-extension-app/register/use-form/integration-details#update-extension-and-action-settings) for information about defining actions using the form-based registration process. See [Action schema](/extension-apps/extension-app-reference/app-manifest-reference/action) for information about action properties in the app manifest file.

## Required actions

#### Verify Email (Verify.Version2.Email)

This contract describes the parameters that Docusign will pass to the external email verification service as well as the parameters expected in the response. You specify the URL for the email verification service in the action definition in the form-based UI or in the extension app manifest.

Verify Email is the label for this action that appears when you register an extension app [using a form](/extension-apps/build-an-extension-app/register/use-form). If you register your extension app [using an app manifest file](/extension-apps/build-an-extension-app/register/use-manifest), the `actions.template` property value for this action is `Verify.Version2.Email`.

### HTTP method

This action initiates a POST request to the external API service.

### Request

```text
{
	"email": "francis@example.com"
}
```

| Property | Type   | Description                  |
| -------- | ------ | ---------------------------- |
| email    | string | The email address to verify. |

### Response

#### Successful case

```json
{
   "verified": true,
   "responseCode": 'VERIFIED',
   "providerResponseCode": 'OK',
}
```

##### Unsuccessful case

```json
{
   "verified": false,
   "responseCode": 'NOT_VERIFIED',
   "providerResponseCode": 'FAILED_BECAUSE_REASONS',
}
```

| Property               | Type      | Occurrence | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| ---------------------- | --------- | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `verified`             | `boolean` | Required   | Whether the email address was successfully verified.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `responseCode`         | `string`  | Required   | Contains a code that indicates the type of response. If verification failed, this code will contain an error code. The following response codes are supported or phone verification:- 'VERIFIED'
- 'NOT_VERIFIED'
- 'NETWORK_TYPE_MOBILE'
- 'NETWORK_TYPE_LANDLINE'
- 'NETWORK_TYPE_LANDLINE_PREMIUM'
- 'NETWORK_TYPE_LANDLINE_TOLLFREE'
- 'NETWORK_TYPE_VIRTUAL'
- 'NETWORK_TYPE_UNKNOWN'
- 'NETWORK_TYPE_PAGER'
- 'NETWORK_TYPE_NULL'
- 'INVALID_NETWORK'
- 'CARRIER_UNAVAILABLE'
- 'UNSUPPORTED_NETWORK_TYPE_MOBILE'
- 'UNSUPPORTED_NETWORK_TYPE_LANDLINE'
- 'UNSUPPORTED_NETWORK_TYPE_LANDLINE_PREMIUM'
- 'UNSUPPORTED_NETWORK_TYPE_LANDLINE_TOLLFREE'
- 'UNSUPPORTED_NETWORK_TYPE_VIRTUAL'
- 'UNSUPPORTED_NETWORK_TYPE_UNKNOWN'
- 'UNSUPPORTED_NETWORK_TYPE_PAGER'
- 'UNSUPPORTED_NETWORK_TYPE_NULL'
- 'INVALID_FORMAT'
- 'INTERNAL_DECLINED'
- 'SERVICE_ERROR' |
| `providerResponseCode` | `string`  | Optional   | Contains response code produced from the app indicating the reasons for success or failure.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |