How to resolve DocuSign eSignature for Salesforce 'error: no protocol' after upgrading to v6.4.x

Issue

After upgrading to DocuSign eSignature for Salesforce v6.4.x you receive the below error when using the Send With DocuSign button.

Error: no protocol: restapi/v2/accounts/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/custom_fields

DfS error no protocol custom_fields

Solution

Re-enter your DocuSign and Connect Users' credentials in the DocuSign Admin Tab

  1. Click the DocuSign Admin Tab > Account
  2. Scroll down and click Modify Account Configuration
  3. Enter your DocuSign Admin User Credentials > Choose correct environment > Click Log In
DfS modify account configuration
  1. Enter your Salesforce Admin User Credentials (your Connect user) > Select I agree... > Click Connect
DfS Connect DS to SF 
Note: If prompted to Add IP Ranges at this point, please see Configure for Organizations Without the Metadata API - DocuSign eSignature for Salesforce
  1. Attempt to use the Send With DocuSign button again.
Note: If the above steps do not resolve the issue, you may need to delete any existing DocuSignAccountConfigurations objects and re-publish Connect. Please follow the steps in How to reconfigure DocuSign eSignature for Salesforce after a Sandbox Refresh by deleting existing DocuSignAccountConfigurations 

Resources

Overview

After refreshing your Salesforce Sandbox Organization all DocuSign eSignature for Salesforce Production data is pulled over. You will need to reestablish the connection from your Sandbox to your DEMO DocuSign Account. In order to do so it is advised to delete any Production instances of the DocuSignAccountConfigurations object.

Important: The following should only be performed by a Salesforce System Administrator who is familiar with the organization's integration. Please use caution if your integration is customized in any way.

Instructions

Note: If you already added the DocuSign Account Configurations Tab please skip to Step #6
  1.  Log into your Salesforce Sandbox and go to Setup >  Create > Tabs
DfS Create Tabs
  1. Next to Custom Object Tabs, Click New
DfS New Custom Tab
  1. Select DocuSignAccountConfigurations from the dropdown menu > Choose a Tab Style > Click Next
DfS New Custom Object Tab
  1. You likely do not want to add this tab to all Profiles, therefore first next to Apply one tab visibility to all profiles Select Default Off from the dropdown. This will set all Profiles to Default Off. Now, Select Apply a different tab visibility for each profile > Locate System Administrator in the list > Select Default On > Click Next
DfS Add Custom Tab to Profiles
  1. You only need to add this Tab to the DocuSign eSignature for Salesforce App. Therefore, Deselect Include Tab in the header row, then locate DocuSign eSignature for Salesforce in the list > Select Include Tab > Click Save

DfS Add Custom Tab to Apps
Now that the DocuSignAccountConfigurations Tab has been created, you need to delete any existing instances of the object.
  1. Click the DocuSign Account Configurations Tab
  2. Important: Make sure the dropdown is set to All and click Go (to ensure you have all of the object instances in view)
  3. Click Del and confirm deletion next to each instance
DfS Delete AccountConfigurations Object
  1. Click the DocuSign Admin Tab. This will take you through the initial configuration steps to reconfigure your Sandbox back to your DocuSign DEMO Account. If you need assistance at this point please see DocuSign eSignature for Salesforce Administration Guide

Learn More

Keywords: DocuSign eSignature for Salesforce, dfs, salesforce, connect, error, no protocol, custom_fields invalid credentials, administration, solution