GuidesAPI ReferenceDiscussions
HomeGuidesAPI ReferenceChangelogDiscussions
GuidesAPI ReferenceDiscussions

Blend provides lenders the ability to create document packages for consumer(s) to view and sign. These packages can be used for disclosures, or any other sort of documents that need to be viewed or signed.

This guide will walk you through how to create a package in Blend. It should be noted that before you can create a package you need your loan and recipients to already be in Blend. For more information on how to do this please see [Create a New Home Lending Application](🔗).

We will start by going over the different components of a package, and end with an example POST.

## Package Types

Blend supports a number of package types. For the most part these package types only affect the text a recipient sees on any emails and tasks. Any exceptions to this will be called out below.

#### Disclosures Package Types

  • INITIAL_LOAN_ESTIMATE

  • REVISED_LOAN_ESTIMATE

  • CLOSING_DISCLOSURE

  • REVISED_CLOSING_DISCLOSURE

  • OTHER_DISCLOSURE

The `OTHER_DISCLOSURE` type does not include very helpful text for the recipient by itself. Instead it is recommended that you provide a name and description when creating the package. A POST using the other package types will ignore any values passed in for name and description.

#### Document Package Types

  • DOCUMENT_PACKAGE

The `DOCUMENT_PACKAGE` type does not include very helpful text for the recipient by itself. Instead it is recommended that you provide a name and description when creating the package.

This type also allows the caller to set the `dueDate` field. This will show the recipient when the lender would like the package completed by. All this field does is show the date to the borrower in their task, there is no logic behind this field.

## Package Envelopes

When creating a package you must define what envelopes you want. An envelope defines how you want the recipients to interact with the documents. This includes things such as tasks and tracking data. Blend tracks each envelope on a package. This allows you to understand exactly what each recipient has done. Each package must consist of one or more envelopes, but you can only have one of each envelope type per package.

#### ESIGN

An `esign` envelope is used when you need the recipients to electronically sign documents. This will create a task that redirects the recipient into Blend's esign provider.

#### REVIEW

A `review` envelope is used when you need the recipients to electronically view documents. This will create a task that presents the documents to the recipient in Blend's document viewer.

#### WETSIGN

A `wetsign` envelope is used when you need the recipients to download, print, sign, and upload documents. This will create a task that requires the recipient to download the document, then upload their signed copy.

## Recipients

Packages support three different types of signers.

  • Borrowers

  • Third Party Recipients (e.g., Non-borrowing owners/spouses, non-obligors, etc.)

  • Lender

#### Borrowers

Any borrower on an application can be a recipient for a package. In order to get `partyId`s you can call [GET application parties](🔗).

#### Third Party Recipients

Any Third Party Recipients on an application can be a recipient on a package. In order to get `partyId`s you can call [GET application parties](🔗).

#### Lender

You can require a lender to be the signer for an `esign` envelope on a package. When having a lender be a signer you must set the `partyId` to `LENDER`. Only the lender user assigned as the loan originator can complete the signing task.

## Documents

After you add recipients to an envelope you will need to say what documents they are supposed to interact with. In order to add a document to a recipient on an envelope you will need to first add the document to Blend.

#### Adding a Document to Blend

In order to add the document to Blend you need to use [POST /documents](🔗). When posting a document for a package you need to ensure the following three fields are properly set.

  • `partyIds` Must contain a list of recipient Ids that should be able to see the document.

  • `shareWithAllParties` Must be set to `true`.

  • `status` Must be set to `SIGNATURE_REQUESTED`.

The `partyIds` and `shareWithAllParties` fields ensure the recipients have the correct document permissions to view and sign. The `status` is needed for the document to be marked for export.

#### Adding a Document to a Recipient

Once you have the Blend `documentId` you can add this to the recipient `metadata` object on the envelope. For `wetsign` and `review` envelopes you just need to add the `documentId`. For `esign` envelopes you will need to also add any tabs the recipient is required to complete.

Blend supports the following tabs:

  • Approve

  • Sign

  • Initial

  • Checkbox

  • Text

  • Notes

  • List

  • Radio Group

## Example Posts

Below are some examples for posting a package. Please see [POST /packages](🔗) for the API schema.