For AI agents: a documentation index is available at the root level at /llms.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
The errors below may be displayed when you 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 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 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 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 authorized user’s account with the API service or identity provider, and make sure that the user has permissions for all of the Scopes specified in the connection settings or the scopes 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 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 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 for information and assistance.
Extension test errors
The errors below may be displayed when you 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 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 or capability 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 page.
Error scheduling execution
An internal system error occurred.
Retry the test. If the issue is persistent, please visit the Docusign Developer Community 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 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 for information and assistance.
User Error: Request failed with status code 404
The Docusign platform was unable to reach the endpoint path.
Confirm that the API service firewall is configured to allow requests from Docusign IP addresses. See 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 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 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 for information and assistance.
