---
title: "Docusign Integration"
canonical: "https://help.agiloft.com/space/HELP/43716358/Docusign%20Integration"
format: markdown
---
Docusign integrates with Agiloft and can be used for a variety of document or contract management needs. Through the Docusign API, Agiloft can create Docusign envelopes and send out documents, which are then signed and returned.

# Terminology

You'll see the following terms in the articles about Docusign:

- **Docusign Envelope**: A container used to send one or more documents for signature using the Docusign system. Envelopes can contain multiple documents and can be sent to several recipients. The documents can have multiple pages. For more information, see the Docusign [terminology](https://support.docusign.com/en/articles/Get-Started-with-DocuSign-eSignature-Basic-Terminology).  In Agiloft CLM, the Docusign Envelopes table contains the records of your Docusign envelopes.
- **Docusign Recipients**: People who receive a Docusign Envelope, usually to sign the documents within them. They are specific to the envelope, and each recipient is assigned a specific Docusign Role (these roles come from Docusign and are distinct from Docusign Signing Roles). In Agiloft CLM, you can select any of the following roles, which are listed with the role and status they correspond to in Docusign:
  - Signer: Needs to Sign
  - CC: Receives a Copy
  - Editor: Allow to Edit
  - Certified Delivery: Needs to View
  - Agent: Specify Recipients
- **Docusign Signing Roles**: Roles in Agiloft CLM that define who the signer is, such as an employee or a customer. They are system-wide definitions and not specific to any envelope. The [Docusign Signing Roles table](https://agiloft-public.atlassian.net/wiki/spaces/SD/pages/44434049) enables you to manage and create roles in your KB.
- **Docusign Users**: Users in the KB who are authorized to create and send Docusign envelopes. A record in the Docusign User table must be linked to an Agiloft CLM user record in the People table or one of its subtables.
- **Docusign Tags**: Formulas or variables placed within documents that tell the Docusign API where signatures, signed dates, initials, and other Docusign fields must go, as well as which signer each field belongs to. They are usually formatted in white font so that the tag text is not visible in the document. For more information, see [Create Document Templates with Docusign Tags](https://agiloft-public.atlassian.net/wiki/spaces/HELP/pages/43714827).

# Setup

To integrate with Docusign, follow the instructions in [Docusign Setup](https://agiloft-public.atlassian.net/wiki/spaces/HELP/pages/43717888).

# Workflow

After setting up the Docusign integration, you can create and send out Docusign Envelopes that have their progress monitored by the system. When all signatures are received, the system automatically updates related records and generates a new document. An example workflow is detailed in the steps below:

1. A contract user who is an authorized Docusign user fills in the appropriate signer fields in the record. Then, the user either creates an attached document using the document template containing the Docusign tags or attaches a document that has already been created.
2. The user clicks Create Docusign Envelope to convert the information into Docusign Envelope and Docusign Recipient records that correspond to the signers.
3. The user previews the envelope and then sends it out. Docusign sends an email with a signing link to the first signer(s). As each signer signs the document, Docusign emails the next signers on the list until everyone has signed the document, at which point the envelope is marked as completed and the signed document is sent back to Agiloft in PDF format.
4. When Agiloft receives the completed document, the system marks the Docusign Envelope record as completed, generates a new Attachment record for the signed PDF document, and changes the Status of the contract to Signed. If the Contract Start Date has passed, the Status of the contract is instead set to Active.

#### Related articles

> Macro (children)