Skip to main content
arrow-left Back to Docusign.com
D
Active Voice
DsimonActive Voice
Active Voice
August 14, 2024
Solved

Embedded signature rejecting recipient contained in envelope creation

  • August 14, 2024
  • 7 replies
  • 368 views

I have successfully created a request for a signature as remote signing using a document created on the fly with htmldefinition. What we’d really like to do is convert this to an embedded signature, so taking that same code which successfully returns an envelope id, I move on to the next endpoint: /restapi/v2.1/accounts/{accountId}/envelopes/{envelopeId}/views/recipient - substituting the accountId as I did for the initial request to create the envelope, and the envelopeId returned upon successful creation. I include body args:

{

    "returnUrl": "https://myreturnurl",

    "authenticationMethod": "none",

    "email": "emailIncludedInOriginalRequestAsRecipient",

    "userName": "RecipientNameIncludedInOriginalRequest",

    "clientUserId": 1000,

}

In response I receive: 

{

"errorCode": "INVALID_REQUEST_PARAMETER",

"message": "The request contained at least one invalid parameter. A value was not found for parameter 'userName'."

}

Does this system not work with documents created on the fly with an htmldefinition? 

Also, in your self-paced University under Embedded Signature Standard View, the link to https://myuni.sampleapps.docusign.com/requestExtracurricularActivity leads to a 502 bad gateway error. 

Best answer by troy.w

Are you implementing Focused View or classic signing?

This shows the difference between the two workflows: https://developers.docusign.com/docs/esign-rest-api/esign101/concepts/embedding/embedded-signing/

 

If you are implementing Focused View for embedded signing, the documentation and guide is available here: https://developers.docusign.com/docs/esign-rest-api/how-to/request-signature-focused-view/

  • Set the return URL to which the user will be forwarded after signing is complete.
  • Add the recipient information to the view, including the signer's email, name, and clientUserID that were set for the recipient who will sign the envelope.
  • Set the messageOrigins field to https://apps-d.docusign.com for developer environments or https://apps.docusign.com for production environments.
  • Add the frameAncestors field. Include the domain where the envelope will be embedded and the same URL as messageOrigins.

Here is a great article walking through the steps https://www.docusign.com/blog/developers/15-minutes-to-better-ux-enhancing-embedded-signing-focused-view

Example

{
    "returnUrl": "http://my.return.url.here.com",
    "authenticationMethod": "none",
    "email": "troyw@gmail.com",
    "userName": "Troy W",
    "clientUserId": "123",
    "frameAncestors": ["https://my.site.com", "https://apps-d.docusign.com"],
    "messageOrigins": ["https://apps-d.docusign.com"]
}

 

7 replies

T
Docusign Employee
troy.wDocusign Employee
August 19, 2024

Hi,

This should work correctly, in your example, clientUserId is an integer, but it should be a string.

For example:

Create Envelope Request (Omitted Data for readability)

{
  "status": "sent",
  "emailSubject": "Test Email",
  "recipients": {
    "signers": [
      {
        "email": "troyw@gmail.com",
        "name": "Troy W",
        "recipientId": "1",
        "clientUserId": "123"
      }
    ]
  },
  "documents": [
    {
      "documentId": "1",
      "name": "contract.pdf",
      "documentBase64": "XXXX",
      "transformPdfFields": true,
      "assignTabsToRecipientId": "1"
    }
  ]
}


CreateRecipientView Request

{
    "email": "troyw@gmail.com",
    "clientUserId": "123",
    "userName": "Troy W",
    "authenticationMethod": "none",
    "returnUrl": "https://www.google.com.au/test"
}

CreateRecipientView Response

{
	"url": "https://demo.docusign.net/Signing/MTRedeem/v1/2a052a6d-39db-458c-bef5-5f082b7098a5?slt=xxxx"
}

 

D
Active Voice
DsimonActive VoiceAuthor
Active Voice
August 19, 2024

Okay, there is another error in the documentation showing clientUserId as an integer. These are the instructions I had been following:

 

T
Docusign Employee
troy.wDocusign Employee
August 20, 2024

Okay, there is another error in the documentation showing clientUserId as an integer. These are the instructions I had been following:

 

 

Thank you for passing that information on, I will ensure that is updated.

The API reference pages are a great source of truth: https://developers.docusign.com/docs/esign-rest-api/reference/envelopes/envelopeviews/createrecipient/

 

If you scroll down to the schema, you will be able to see in more detail the properties, types and description:
 

clientUserId

string

A sender-created value. If provided, the recipient is treated as an embedded (captive) recipient or signer.

Use your application's client ID (user ID) for the recipient. Doing so enables the details of your application's authentication of the recipient to be connected to the recipient's signature if the signature is disputed or repudiated.

Maximum length: 100 characters.

 

D
Active Voice
DsimonActive VoiceAuthor
Active Voice
August 20, 2024

I got that to work but am struggling with the imbedding because of the framesAncestor. I made sure that domain is in the redirect uri and original url. Do you know how I might be able to fix that? 

Thanks. I really appreciate the help. 

T
Docusign Employee
troy.wDocusign EmployeeAnswer
August 21, 2024

Are you implementing Focused View or classic signing?

This shows the difference between the two workflows: https://developers.docusign.com/docs/esign-rest-api/esign101/concepts/embedding/embedded-signing/

 

If you are implementing Focused View for embedded signing, the documentation and guide is available here: https://developers.docusign.com/docs/esign-rest-api/how-to/request-signature-focused-view/

  • Set the return URL to which the user will be forwarded after signing is complete.
  • Add the recipient information to the view, including the signer's email, name, and clientUserID that were set for the recipient who will sign the envelope.
  • Set the messageOrigins field to https://apps-d.docusign.com for developer environments or https://apps.docusign.com for production environments.
  • Add the frameAncestors field. Include the domain where the envelope will be embedded and the same URL as messageOrigins.

Here is a great article walking through the steps https://www.docusign.com/blog/developers/15-minutes-to-better-ux-enhancing-embedded-signing-focused-view

Example

{
    "returnUrl": "http://my.return.url.here.com",
    "authenticationMethod": "none",
    "email": "troyw@gmail.com",
    "userName": "Troy W",
    "clientUserId": "123",
    "frameAncestors": ["https://my.site.com", "https://apps-d.docusign.com"],
    "messageOrigins": ["https://apps-d.docusign.com"]
}

 

D
Active Voice
DsimonActive VoiceAuthor
Active Voice
August 22, 2024

Okay, thanks. I’m using focused view, but hadn’t previously seen that I needed to set the messageOrigins and frameAncestors to include https://apps-d-docusign.com. 

D
Active Voice
DsimonActive VoiceAuthor
Active Voice
August 22, 2024

That WORKS! So happy! Thank you!

Code of ConductAccessibility statement

Docusign Community

Code of Conduct