> 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 # Troubleshooting > Get tips for troubleshooting extension app errors. This topic provides troubleshooting guidance for these types of errors: * [Connection test errors](/extension-apps/troubleshooting#connection-test-errors) * [Extension test errors](/extension-apps/troubleshooting#extension-test-errors) * [Errors caused by an ad blocker](/extension-apps/troubleshooting#errors-caused-by-an-ad-blocker) ## Connection test errors The errors below may be displayed when you [run a connection test](/extension-apps/build-an-extension-app/test/integration-tests#run-a-connection-test) on the Developer Console Testing page. | Error message | Description | Troubleshooting | | ----------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | A refresh token was not returned from the token server. | The API service or the identity provider has not been configured to supply refresh tokens. | Check the API service documentation to confirm that refresh tokens are supported and to find out what is required to enable them. If you’re using an identity provider, make sure that it's configured to allow refresh tokens. See [Authorization](/extension-apps/build-an-extension-app/it-infrastructure/authorization) for more information. | | There was an error creating the connection instance. | An internal system error occurred when the API service or the identity provider returned an authorization code to the Docusign platform. | Retry the test. If the issue is persistent, please visit the [Docusign Developer Community](https://community.docusign.com/developer-59) for information and assistance. | | There was an error creating the OAuth token. | An internal system error occurred when the API service or the identity provider returned an authorization code to the Docusign platform. | Retry the test. If the issue is persistent, please visit the [Docusign Developer Community](https://community.docusign.com/developer-59) for information and assistance. | | There was an error exchanging the authorization code for a token. | The Docusign platform was unable to exchange the authorization code for an access token. This can be caused by:- An invalid token URL in the extension app manifest - An invalid or expired authorization code returned by the API service or the identity provider - A network or internet issue when the Docusign platform attempted to exchange the authorization code for an access token - The authorization service or identity provider service not being available | * Check the [Token URL](/extension-apps/build-an-extension-app/register/use-form/integration-details#update-connection-settings) in the connection settings or the [connections.params.customConfig.tokenUrl](/extension-apps/extension-app-reference/app-manifest-reference/connection#connection-custom-configuration-schema) in the extension app manifest and make sure that the value is correct. * Check the authorized user's account with the API service or identity provider, and make sure that the user has permissions for all of the [Scopes](/extension-apps/build-an-extension-app/register/use-form/integration-details#update-connection-settings) specified in the connection settings or the [scopes](/extension-apps/extension-app-reference/app-manifest-reference/connection#connection-parameters-schema) specified in the extension app manifest. * Confirm that the authorization service or identity provider service is running. * Confirm that the API service or identity provider firewall is configured to allow requests from Docusign IP addresses. See [Firewall configuration](/extension-apps/build-an-extension-app/it-infrastructure/network-configuration#firewall-configuration) for details. | | There was an error persisting the OAuth token. | While exchanging the authorization code for an access token, the Docusign platform was unable to save the access token, possibly due to network issues. | Retry the test. If the issue is persistent, please visit the [Docusign Developer Community](https://community.docusign.com/developer-59) for information and assistance. | | There was a problem initializing the connection test. | The Docusign platform was unable to generate the authorization URL or initiate the connection test. | Retry the test. If the issue is persistent, please visit the [Docusign Developer Community](https://community.docusign.com/developer-59) for information and assistance. | ## Extension test errors The errors below may be displayed when you [run an extension test](/extension-apps/build-an-extension-app/test/integration-tests#run-an-extension-test) on the Developer Console Testing page. | Error message | Description | Troubleshooting | | -------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | \[error from API service] | Docusign successfully sent the request, but an error response was returned. The Developer Console displays the error details received from the API service. | * Review the API service documentation to determine why it could not process the request. * For HTTP errors such as 403 Forbidden, 404 Not Found, 502 Bad Gateway, or 503 Service Unavailable, confirm that the API service firewall is configured to allow requests from Docusign IP addresses. See [Firewall configuration](/extension-apps/build-an-extension-app/it-infrastructure/network-configuration#firewall-configuration) for details. | | Error executing the extension | The JSON request body is missing a required property, includes a property that is invalid, or otherwise does not conform to the expected schema. | Check the [action](/extension-apps/extension-apps-101/concepts/actions) or [capability](/extension-apps/extension-apps-101/concepts/capabilities) contract for the request, update the request body if it doesn't conform to the contract, and retry the test. You can access the action and capability contracts for each extension from the [Extension contracts](/extension-apps/extension-app-reference/extension-contracts) page. | | Error scheduling execution | An internal system error occurred. | Retry the test. If the issue is persistent, please visit the [Docusign Developer Community](https://community.docusign.com/developer-59) for information and assistance. | | Failed to insert actionTest: createActionTest - AppVersion with id \[ID] could not be found. | The extension app manifest has been updated since the extension app was installed to your account. | Uninstall the extension app and reinstall it. See [Run a connection test](/extension-apps/build-an-extension-app/test/integration-tests#run-a-connection-test) for installation instructions. | | Failed to insert actionTest: Invalid record returned | An internal system error occurred. | Retry the test. If the issue is persistent, please visit the [Docusign Developer Community](https://community.docusign.com/developer-59) for information and assistance. | | User Error: Request failed with status code 404 | The Docusign platform was unable to reach the endpoint path. | - Check [Params URI](/extension-apps/build-an-extension-app/register/use-form/integration-details#update-extension-and-action-settings) in the [action](/extension-apps/extension-apps-101/concepts/actions) or [capability](/extension-apps/extension-apps-101/concepts/capabilities) settings or [actions.params.uri](/extension-apps/extension-app-reference/app-manifest-reference/action) in the extension app manifest and make sure that it's correct and reachable. - Confirm that the API service firewall is configured to allow requests from Docusign IP addresses. See [Firewall configuration](/extension-apps/build-an-extension-app/it-infrastructure/network-configuration#firewall-configuration) for details. | ## Errors caused by an ad blocker ### Description When you try to install an extension app to your account in the [App Center](/extension-apps/extension-apps-101/app-center) or uninstall an app, this error message is displayed: `We encountered an unexpected error. Reload the page and try again.` ### Cause This issue can occur when your device or network is running an ad blocker. ### Resolution Either disable the ad blocker, or add [these domains](/extension-apps/build-an-extension-app/it-infrastructure/network-configuration#ad-blocker-configuration) to the allowed list for the ad blocker. If disabling the ad blocker or adding the domains to the allowed list doesn't resolve the issue, please visit the [Docusign Developer Community](https://community.docusign.com/developer-59) for information and assistance. ## Next steps * Find out how to [test an extension app](/extension-apps/build-an-extension-app/test). * Get details about the structure of the [extension app manifest](/extension-apps/extension-app-reference/app-manifest-reference). * Retrieve [logs](/extension-apps/troubleshooting/review-logs) of extension app installations and other activity.