E-SIGN Block

What's New?

As of March 5, 2025

Adding 2FA requirement for signing documents in DocuSign

A Phone Number field has been added as an optional input for scenarios where 2FA (Two-Factor Authentication) is enabled in the customer's DocuSign account.

 

SKIP AHEAD TO
Why would you use E-Signatures?
Which E-Sign Vendors can I use in Checkbox?
How to set up your E-Sign block
Adding 2FA requirement for signing documents in DocuSign


Why would you use E-Signatures?

E-signatures allow you to sign documents electronically, removing the need for physical paper documents and creating more efficiency with handling signed documents. Other contents such as the name of signatories and exact dates of signing will be shown inside the document.

 

Which E-Sign Vendors can I use in Checkbox?

Checkbox supports e-signatures by DocuSign and Adobe Sign. Learn how you can enable DocuSign OR enable Adobe Sign.

 

How to set up your E-Sign block

  1. In Studio, click onto a E-Sign block and click ‘Add Recipients’

    V1.16_Relase_Notes___Email___Wiki_-_Google_Docs_2020-06-09_11-12-15.png


  2. Enter the name and emails of the recipients. TXT#, LIST# and USER# variables and static text are supported for the recipient name and email fields. Variables must be enclosed in curly braces {{ }} to be valid. Learn more about Operators and Variables.

    Notes:

    LIST variables are typically used from Merge blocks that have merged the names and emails of e-signature recipients from text input fields in FORM blocks. Learn more about Merge blocks.

    If LIST variables are used, the list of the names and emails of e-signature recipients in the Merge block or LIST block must correspond to each other by order and have the same length.

     

    Can I specify the order of signing by the signatories?

    Yes. The order of signing by the signatories are determined by the order of the recipient fields. For example, in the below screenshot, Jane Wilson will be the first signatory to receive the e-signature email. Once Jane has signed, the signatory chosen inside a User Picker (i.e. {{USER12.name}}) will sign next. If a LIST variable is used, then it will send to the recipients within the LIST variable simultaneously.

    V1.16_Relase_Notes___Email___Wiki_-_Google_Docs_2020-06-09_11-13-43.png


  3. Assign the role of each recipient with either “Signer” or “CC”.

    Note: The behaviour of e-signature emails for CC recipients vary depending on whether the Project Team uses DocuSign or Adobe Sign.

    • DocuSign: CC recipients will receive the signed document after the Signers have signed the document via email. CC recipients are not able to sign the document.

    • Adobe Sign: CC recipients will initially receive a notification email informing that they have been copied into the e-signature emails. Once the Signer has signed the document using Adobe Sign, the CC recipient will also receive the signed document via email. CC recipients are not able to sign the document.

      V1.16_Relase_Notes___Email___Wiki_-_Google_Docs_2020-06-09_11-15-31.png


  4. Scroll down and select the Report that either DocuSign or Adobe Sign should send to the recipients.

    Note: Reports must first be uploaded or generated using the Doc Gen block for it to be referenced. Learn more about Rich Style Document Templates AND specifying E-Signature Location on a Document.

    V1.16_Relase_Notes___Email___Wiki_-_Google_Docs_2020-06-09_11-17-18.png


  5. Provide an e-signature email subject and body.

    Note: Referenced variables, such as {{Client}} and/or meta variables can be used to give a more personalised notification. Learn more about Operators and Variables AND/OR see the list of all meta variables.

    Limitation: By DocuSign limitation, the subject line can only hold up to 100 characters

    V1.16_Relase_Notes___Email___Wiki_-_Google_Docs_2020-06-09_11-18-05.png

 

Adding 2FA requirement for signing documents in DocuSign

  1. Add a Text Field for Contact Number Input
    Within the FORM block where signer information is entered, add a text field for the contact number.

    Contact Number - TEXT FIELD.png

    Important: Ensure that the number follows the international format. This means the number must begin with a "+" followed by the country code and the number itself. This format is required for users to receive the 2FA verification message.

  2. Use Regular Expression on the text field for Format Validation (optional)
    To ensure the number is in the correct international format, apply a Regular Expression (e.g., ^\+(?:[1-9]\d{0,2})[-\s]?(?:\d{1,4}[-\s]?){2,5}\d{1,4}$). This helps verify that the entered number is valid and ensures the signer will receive the 2FA message.

    FIELD VALIDATION.png

  3. Configure the ESIGN Block
    Click on the ESIGN block and enter the variable name of the contact number under the Phone Number field.

    ESIGN BLOCK config.png

 


Related Articles