DocuSign

The DocuSign integration collects electronic signatures in two places. Applicants sign their application (the application PDF, an optional Terms and Conditions page and selected letters) as the last step of submitting it, and staff send letters from a profile for signature by the applicant and any number of additional signers. An administrator connects one DocuSign account for the whole institution; every envelope is sent on behalf of the DocuSign user who connected it.

Note: Full Fabric uses one signature provider at a time. When PandaDoc is enabled it is used instead, even if a DocuSign account is connected, and the Request signature action on letters is hidden.

Connect your DocuSign account

Go to Settings → Other integrations → DocuSign. DocuSign connects by signing in, not with typed credentials, and there is no separate enable switch: digital signatures are available as soon as an account is connected.

  1. Click Authenticate. The whole window moves to DocuSign's sign-in page.
  2. Sign in as the DocuSign user that should send the envelopes. It must be able to create envelopes and request signatures.
  3. Approve the access DocuSign asks for. Full Fabric requests permission to send signature requests and to act on behalf of this user, so it can create envelopes when nobody is signed in to DocuSign.
  4. DocuSign returns you to the DocuSign settings page, which now shows Active.
Shown on the page Meaning
Active / Inactive Whether an account is connected
Account ID The DocuSign account Full Fabric uses: the default account of the user who authenticated
Impersonated profile ID The DocuSign user envelopes are sent on behalf of

Click Re-authenticate to switch to another DocuSign user, or after changing a setting in your DocuSign account. Each authentication replaces the previous user and checks your DocuSign account settings again. The page has no disconnect action.

Signatures on applications

Signing is set per application template, in Settings → Templates & documents → Application templates, on the template's Digital Signature tab. The tab is not offered on registration templates or on locked templates, and its controls stay disabled until a DocuSign account is connected.

Setting Effect
Sign Application PDF The applicant signs the application PDF. The signature goes on the cover, or on the Terms and Conditions page when one is included
Include a Terms and Conditions page Adds a page to the application PDF with your own Title for the page and Page content; the signature is placed below the content
Sign Letter Templates Adds letters to the same signing session. Select Letter templates lists only letter templates marked Requires digital signature, and each letter needs a signature merge field (see Signatures on letters)
Digital signature email subject Subject of the DocuSign envelope, per language. Defaults to "Please sign your application"

What applicants see

When signing is required, the application's submit button reads sign & submit. Clicking it:

  1. Checks the application is complete. If anything is missing, the usual errors are shown and nothing is sent to DocuSign.
  2. Generates the PDF of the application and of each selected letter, and creates a DocuSign envelope for the applicant.
  3. Sends the applicant straight into the DocuSign signing session in the same window. No email is needed for this step.
  4. When the applicant finishes, DocuSign returns them to Full Fabric, which checks with DocuSign that the envelope is completed and then submits the application.

If the applicant leaves DocuSign before finishing, the application stays unsubmitted and they can click sign & submit again. Full Fabric reuses their envelope: it replaces the documents with the latest answers when your DocuSign account allows envelope correction, and otherwise creates a new envelope if the application changed since the last attempt.

  • An application submitted by a staff member is accepted without a signature; the requirement applies to applicants.
  • When an application is unsubmitted, its signature is cleared and the applicant signs again when resubmitting.

Signed application documents

Open the application on the applicant's profile and choose to download it. The Download application window has a Signed documents section with Download signed Application PDF and Download signed Letter (name) links, or "This application hasn't been signed yet." Full Fabric does not keep its own copy of the signed PDF: each link fetches the signed document from DocuSign at the time you click it.

Signatures on letters

Staff can send an individual letter for signature from a profile's Letters tab.

  1. Mark the letter template as signable: in Settings → Templates & documents → Documents → Letter Templates, open the template and tick Requires digital signature ("Enable digital signatures for this template.").
  2. Place signature merge fields in the template. signature.full, signature.initials, signature.date and signature.location belong to the applicant; signature2.full, signature2.initials and so on belong to the first additional signer, signature3.* to the second, and so on.
  3. On the profile's Letters tab, create the letter and click Request signature.
  4. In the Request signature window, Applicant/Student (required) is always included and signs first. Tick Additional signer and enter the EXTERNAL PERSON NAME and EXTERNAL PERSON EMAIL; ticking a signer adds a box for the next one. Click Send signature request.

DocuSign then emails each signer in turn, the applicant first and each additional signer in the order listed, with the subject "Please sign: " followed by the letter name. No webhook setup is needed in DocuSign: each envelope tells DocuSign where to report progress, and the Signature status column updates as each signer finishes.

Signature status Meaning
Not required The letter's template does not require a signature
Signature pending Sent; not every signer has finished
Signature pending (1/2 signed) With additional signers: how many have signed so far
Letter signed Every signer has signed

Once a request is sent, Request signature shows the signers read-only. When the applicant is the only signer it also offers Copy DocuSign Link, a Full Fabric link the applicant can open while signed in to Full Fabric to sign straight away. When the letter is signed, its PDF icon downloads the signed copy from DocuSign.

Warning: Deleting a letter does not cancel its DocuSign request. The signers can still sign, and the signed copy will not reach Full Fabric.

Common failures

What you see Usual cause Fix
Warning "Allow Envelope Correct" is disabled in DocuSign on the settings page Envelope correction is turned off in your DocuSign account. The warning explains that applicants who leave signing before finishing cannot resubmit Ask your DocuSign account manager to enable the setting, then click Re-authenticate
Status Inactive, and the template's Digital Signature tab says digital signature must first be enabled No DocuSign account is connected Click Authenticate
"No impersonated profile. Re-authenticate to set one." The connection has no DocuSign user to send as Click Re-authenticate
An applicant comes back from DocuSign but the application is not submitted They left the signing session before finishing Ask them to click sign & submit again
"Please enter the name for additional signer" or "Please enter a valid email address for additional signer" A ticked additional signer is incomplete Complete or untick that signer
"Failed to send signature request. Please try again.", or DocuSign's own message, in the Request signature window DocuSign rejected the envelope Check the letter and its merge fields, then try again
"Letter isn't signed" or "Application isn't signed" when downloading Not every signer has finished Wait for the remaining signatures

Permissions

Action Who can do it
Connect or re-authenticate DocuSign Staff with Global integrations, see Integrations
Configure the Digital Signature tab of an application template Staff with applics.application_templates_change
Send a letter for signature Staff with core.institutions.profile_letters_change
Download a signed letter Users with documents.letters_access
Download a signed application Staff with applics.applications_download