DocuSign agreement failed: in-app signing (In-Session) isn't enabled

Updated

Applies to: Organizations that use DocuSign steps in tasks

This feature is available when it's turned on for your organization. If you don't see it, contact your OnRamp team.

When a DocuSign step in a task becomes ready to answer, OnRamp sends the agreement automatically. While it sends, the step shows Generating Agreement. If the send fails for this reason, an error message appears on screen:

The connected DocuSign account is not enabled for in-app signing (In-Session). Ask your DocuSign administrator to enable it, then try again.

Whoever opens the step when it becomes ready to answer can see this message. That's a customer user in the customer portal, or the internal user the step is assigned to in the app. It doesn't appear in a preview.

Why it happens

Signers sign inside the customer portal or the app, not from a DocuSign email. DocuSign calls this in-app signing In-Session, and the DocuSign account has to allow it. When the connected account doesn't, DocuSign rejects the agreement.

Nothing is saved on the step when this happens. The step shows The agreement will be generated once the step is ready to answer.

Fix it

DocuSign is available when it's turned on for your organization. If you don't see it, contact your OnRamp team.

  1. Ask your DocuSign administrator to enable In-Session (in-app signing) on the DocuSign account connected to OnRamp.

  2. Optional: To confirm the connection, go to Settings > Integrations+ and open DocuSign. If the status is Reconnect required, a Super Admin or Integrator selects Reconnect DocuSign. Creators see the status but not the button, with a message to ask someone who can manage the connection to reconnect it.

  3. Once In-Session is enabled, open the task with the DocuSign step again. OnRamp tries to send the agreement again.

When it works, the step creates its agreement. Each step gets only one agreement, so opening it again won't create a duplicate.

If you see a different message, it has a different cause:

  • No DocuSign connection found for this vendor means DocuSign isn't connected.

  • A message saying the step references a DocuSign template that is not available means the step's template can't be found.

  • A message saying the step has a signer with no template role to bind to means a signer needs a template role.

  • A message saying the step is not configured with a template or document to send means the step needs a template or document.

  • DocuSign envelope creation failed with status followed by a number means DocuSign rejected the agreement for another reason. Any DocuSign error code appears in parentheses.

  • DocuSign envelope creation timed out and no envelope was found for the transaction id means the send timed out before DocuSign created the agreement.

Still stuck?

Contact support with the project name, the task and step name, the time you saw the error, and the exact message. If the message includes a status or DocuSign error code, include it.

More in Troubleshooting