> 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

# Functional tests

> Learn how to verify that an extension app works as expected when invoked from a Docusign envelope or workflow.

Functional tests enable you to launch extension app functionality from a Docusign agreement process to verify that it works correctly for end users.

You can set up a functional test that invokes an extension app from these Docusign features:

* [Workflows](/docs/workflow-builder-api/workflow-builder101/workflows): Create an Agreement Builder workflow that invokes your extension app. Execute the test by creating and executing an instance of the workflow. This enables you to run through the workflow steps as an end user would and verify that the extension behaves as expected.
* [Envelopes](/docs/esign-rest-api/esign101/concepts/envelopes): Create an [eSignature template](https://support.docusign.com/s/document-item?bundleId=xry1643227563338\&topicId=dqj1578456412286.html\&rsc_301), add a document to it, and configure fields that  invoke your extension app. Execute the test by generating an envelope from the template and completing the signing process. When you enter values in the fields that invoke the extension, you can verify that the extension works correctly.
* [Agreement Manager](https://support.docusign.com/s/document-item?language=en_US\&bundleId=pqz1702943441912\&topicId=adf1702945446135.html): Invoke your extension app to locate files on a cloud storage system and import them into Agreement Manager. As you complete this test, you can verify that the extension can successfully retrieve cloud storage drive, folder, and file information and upload files.

Below is a list of [extensions](/extension-apps/extension-apps-101/supported-extensions), the functional test types that Docusign supports for each extension, and links to procedures for setting up and executing the tests.

| Extension type    | Extension                                                                                                                                                                       | Workflow test procedure                                                                                                                                                                                                                                                                                                                                                                | Envelope test procedure                                                                                                              | Agreement Manager test procedure                                                                                                                                     |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Connected fields  | Connected fields                                                                                                                                                                | Not supported in the current release                                                                                                                                                                                                                                                                                                                                                   | [Connected fields extension envelope test](/extension-apps/build-an-extension-app/test/functional-tests/connected-fields-envelope)   | Not supported in the current release                                                                                                                                 |
| Data IO           | Data IO                                                                                                                                                                         | [Data IO extension workflow test](/extension-apps/build-an-extension-app/test/functional-tests/data-io-workflow)                                                                                                                                                                                                                                                                       | Not supported in the current release                                                                                                 | Not supported in the current release                                                                                                                                 |
| Data verification | Bank account owner verification Bank account verification Business FEIN verification Email address verification Phone verification Postal address verification SSN verification | Not supported in the current release                                                                                                                                                                                                                                                                                                                                                   | [Data verification extension envelope test](/extension-apps/build-an-extension-app/test/functional-tests/data-verification-envelope) | Not supported in the current release                                                                                                                                 |
| File IO           | File input cloud storage                                                                                                                                                        | Not supported in the current release                                                                                                                                                                                                                                                                                                                                                   | Not supported in the current release                                                                                                 | [File input cloud storage extension Agreement Manager test](/extension-apps/build-an-extension-app/test/functional-tests/file-input-cloud-storage-agreement-manager) |
| File IO           | File output cloud storage                                                                                                                                                       | [File output cloud storage extension workflow test](/extension-apps/build-an-extension-app/test/functional-tests/file-output-cloud-storage-workflow)                                                                                                                                                                                                                                   | Not supported in the current release                                                                                                 | Not supported in the current release                                                                                                                                 |
| File IO           | File output system of record                                                                                                                                                    | [File output system of record test: Workflow step creates envelopes](/extension-apps/build-an-extension-app/test/functional-tests/file-output-system-of-record-workflow-step-creates-envelopes) [File output system of record test: An event triggers the workflow](/extension-apps/build-an-extension-app/test/functional-tests/file-output-system-of-record-event-triggers-workflow) | Not supported in the current release                                                                                                 | Not supported in the current release                                                                                                                                 |
| File IO           | File output tabular format                                                                                                                                                      | [File output tabular format extension workflow test](/extension-apps/build-an-extension-app/test/functional-tests/file-output-tabular-format-workflow)                                                                                                                                                                                                                                 | Not supported in the current release                                                                                                 | Not supported in the current release                                                                                                                                 |

The tests will run against the external API service environment (development, test, or production) configured in the extension app [registration](/extension-apps/build-an-extension-app/register). See [Test against different environments](/extension-apps/build-an-extension-app/test#test-against-different-environments) for information about switching environments.

## Next steps

* Get details about the structure of the [extension app manifest](/extension-apps/extension-app-reference/app-manifest-reference).
* Learn how to run [integration tests](/extension-apps/build-an-extension-app/test/integration-tests).
* See how to use the [App Center preview](/extension-apps/build-an-extension-app/test/app-center-preview).