Skip to main content

Hi all,

I am getting the following error in one of my Salesforce sandboxes, not in others. The error is from a Docusign log, the actual page when I try to access DAL, Gen Templates, or sending a Docusign from a button is blank page with a loading wheel.

Failed to complete product setup. dfsle.APIException: [401] Unauthorized Reference ID: (dfsle)

I have tried the suggestions in this article however to no luck. Could anyone share any guidance on how to resolve this?

Many thanks!

Molly

Adding here for anyone else who might encounter this issue. I spoke to Docusign Support who advised this was caused by a Salesforce update.

To resolve the issue, Docusign provided a later version of DAL (I was using 6.7.0, upgraded to 7.9.2). I upgraded it in my sandbox, and after disconnecting and reconnecting, it worked as expected.


Adding here for anyone else who might encounter this issue. I spoke to Docusign Support who advised this was caused by a Salesforce update.

To resolve the issue, Docusign provided a later version of DAL (I was using 6.7.0, upgraded to 7.9.2). I upgraded it in my sandbox, and after disconnecting and reconnecting, it worked as expected.

Hello, Mollyh,

I have the same issue. ¿Do you now how can I upgrade Docusign App Launcher to 7.9.2? In Appexchange I see the newest version is 7.8.0

Thank you


Adding here for anyone else who might encounter this issue. I spoke to Docusign Support who advised this was caused by a Salesforce update.

To resolve the issue, Docusign provided a later version of DAL (I was using 6.7.0, upgraded to 7.9.2). I upgraded it in my sandbox, and after disconnecting and reconnecting, it worked as expected.

Hello, Mollyh,

I have the same issue. ¿Do you now how can I upgrade Docusign App Launcher to 7.9.2? In Appexchange I see the newest version is 7.8.0

Thank you

Hi, it was the link provided to me by DS Support - if upgrading to 7.8.0 does not resolve your issue I would raise a case with Docusign to confirm. 😊


Hey ​@mollyh,

Welcome to the Docusign Community great to have you here!

We're delighted that things are working now. Your solution is a valuable addition to our community, thank you for sharing  😊

Favor, could you please mark your answer as "Best Answer" ✅, to help other community members find trusted answers and follow similar steps. 

If anything else comes up or you hit another roadblock, don’t hesitate to reach out here in the Community.

Wishing you a smooth rest of your day!

 

Sincerely,

Melanie | Docusign Community Moderator


This error was caused by Winter 26 release, which deployed this weekend in Sandboxes.


To prevent this error from occurring in Production when the release is deployed (the Winter '26 Major Release deploys in October), can I install DAL version 7.9.2 in Production now or do I have to wait for the release to be released?
 


Hi ​@Pedraligan,

Thanks for posting your question! For other community members visibility, sharing the recap of the issue and suggested solution:

A consequential impact has been observed on the Docusign Apps launcher where Sandboxes or demo account with DAL were disrupted due to Salesforce's most recent update - Salesforce Winter 26 upgrade deployment in the Sandboxes environment.

The fix is to update Docusign Apps Launcher using the following update link. Important Note: After clicking the link, you will be directed to a login screen. Please replace the login with the test in the URL to ensure you are logged into the Sandbox environment for the update 👉 https://login.salesforce.com/packaging/installPackage.apexp?p0=04tKg0000004eWr

 

Please be advised that the Winter 26 deployment will start in production, but right now, the instruction internally is to update by the 20th of September 2025.

Reminder for those on lower versions of DAL (below 6.0), please make sure to upgrade the DAL version. Comprehensive guide here 👉 how to upgrade DAL

To know exactly when the upgrade will be enforced in your Production organization, please see the steps below:

1. Log in to Salesforce.

2. Go to Setup → Company Information to see your instance name (e.g., NA34, EMEA17).

3. Visit  https://status.salesforce.com/current/maintenances

4. Enter your instance id and locate your instance under the Maintenance tab to find your scheduled Winter ’26 release date.

Let us know if you have questions— we're here for you!

 

Sincerely,

Melanie | Docusign Community Moderator
If this helped clarify things, feel free to Like👍and click "Best Answer"


Hi ​@mollyh , 

could you help to understand the below error. the system has DAL version 6.9
 

 


Hi ​@Akshay,

Thank you for posting your question — we're glad you're here and happy to share our knowledge with you.

Here is an article on the steps that cause the issue 👉 Docusign Apps Launcher error: "You have not granted or have revoked your consent to be impersonated by Docusign Apps Launcher"

Basically, you will need to upgrade. Version 6.9 had various authentication issues, and we had to push a fix.  Please upgrade to the current version showing in appexchange.salesforce.com.  I believe it is 7.11.1. You have not been granted access, or a revoked authentication error most likely is being caused by the fact that with 6.9, it was hard for the authentication tokens to refresh.  The most recent SF updates, such as the Connect App Security Update, have further broken connections/configurations that were not properly set up or authorized.  This is most likely why you are seeing this issue all of a sudden, rather than previously. Please perform the following steps.

  1. Update the managed package to the current package listed in SF AppExchange
  2. Install the Connected App for Docusign within Salesforce.  (Make sure the customer does not change any settings once installed)
    1. https://support.docusign.com/s/document-item?language=en_US&bundleId=srl1586134368658&t[…]Id=refbdaee1ac-b187-4df9-94f2-a094f9f47ef2.html&_LANG=enus

3. Once the update is done and the Connected App is installed they will need to disconnect via the Troubleshooting page and then reauthorize with the integration user following the below steps:1)  ACCESS TROUBLESHOOTING PAGE:

  • In Salesforce go to Salesforce Setup, Visualforce Pages, "t" for troubleshooting and choose the one with a dfsle Namespace, open and Preview to view the menu

2)  SELECT ONE OF THE FOLLOWING TO DISCONNECT:

  • "Disconnect Account and Preserve Users" This is like a soft reset and should be done if configuration and user are staying the same

        or looking for minimal impact to users.

  • "Disconnect Account and Reset Users” (NOTE This step removes all users from DS Setup, but can be added back in bulk) This is like      

        a hard reset and is done when:
           >> First option doesn't resolve behavior.
           >> Updating connecting user, Salesforce org, DocuSign account
           >> Errors generated with Admin tasks or Consent has been revoked.
           >> Sandbox Refreshes
3) CLEAR BROWSER HISTORY:

  • Once complete, confirm you are logged out of all DocuSign instances in all tabs, clear cache and cookies or go into Incognito browser, log back into Salesforce via login.salesforce.com for Production or test.salesforce.com for Sandbox.

4) RECONNECT DAL:   FOR VERSIONS 6.8.1 AND LOWER:

  • Go DocuSign Setup in Salesforce
  • For Production Select Login or for Demo select Advanced Options and then Login to Demo
    • (NOTE***IF YOU ARE NOT IMMEDIATELY PROMPTED with the DocuSign Login screen, but instead Salesforce's login screen, STOP and go into an Incognito Browser, your DocuSign credentials cached which can cause improper authentication and possible repeating of above the steps in order to setup configuration correctly. In Salesforce if using MFA or SSO user must choose custom domain when prompted to login into Salesforce ***
  • Select the desired Account
  • Select Allow Access and Login to Salesforce again and wait for system to process the request

   FOR VERSION 6.9 AND HIGHER:

  • Go DocuSign Setup in Salesforce and select Allow Access
  • A popup window appears and select Allow Access
    • (NOTE*** if the 2nd Allow Access does not appear stop because you will not successfully regrant consent for Salesforce. You will need to revoke all Connections for DocuSign before proceeding. Once the Connections are revoked try again)
  • Login to Salesforce and wait about 5 seconds for the system to process
  • For Production Select Login or for Demo select Advanced Options and then Login to Demo
    • (NOTE***IF YOU ARE NOT IMMEDIATELY PROMPTED with the DocuSign Login screen, but instead Salesforce's login screen, STOP and go into an Incognito Browser, your DocuSign credentials cached which can cause improper authentication and possible repeating of above the steps in order to setup configuration correctly. In Salesforce if using MFA or SSO user must choose custom domain when prompted to login into Salesforce ***
  • Select the desired Account
  • Wait for system to process the request

(Steps 5 and 6 are optional and are for adding users for DAL)
5)  ADD DOCUSIGN LOGIN PERMISSION SET TO USERS TO SIMPLIFY USER MANAGEMENT AND SILENT ACTIVATION:

  • Go to Salesforce Setup > Permission Sets > DocuSign Login permission set.
  • Select all users that need to have access to DocuSign Apps Launcher

6)  ADD USERS:

  • Go Manage Users within DocuSign Setup and Add User in top right corner
  • Change the left filter picklist to "Permission Sets" and right filter picklist choose "DocuSign Login"
  • Select all the users and Next
  •  Assign needed permissions and ALWAYS, ALWAYS, ALWAYS, SELECT THE CHECKBOX TO UPDATE EXISTING DOCUSIGN USERS to prevent users from being stuck in pending status and/or failing authentication due to duplicate profile being created in DocuSign
  • Add and Save

7)  TEST/REAUTHORIZE:

  • Make sure you are logged out of DocuSign and go into Salesforce and to a record and select the button to Generate > select Authorize
    • NOTE***IF YOU ARE NOT IMMEDIATLEY PROMPTED to first log into DocuSign stop and open an incognito Access > Next put Salesforce Credentials in if prompted. Once this is done you will be landed in the envelope and proceed as normal.

Hope this helps. Let us know if you need further assistance—we're here for you!

 

Sincerely,

Melanie | Docusign Community Moderator
If this helped, feel free to Like👍and click "Best Answer"


 

Thank you, Melanie. Let me try your sugggestion.


You're welcome ​@Akshay. We're here if you have any questions 😊

 

Sincerely,

Melanie | Docusign Community Moderator