Deliver Signed Documents By Email

The following guide shows you how to enable delivery of signed documents through email to your signers.

Once a package (transaction in the UI) has been completed, you can automatically deliver signed documents to your signers.

The Code

Below is a sample code on how to build your Signer object in order to deliver signed documents by email once the transaction has been completed.

DocumentPackage superDuperPackage = newPackageNamed(getPackageName())
                .withSigner(newSignerWithEmail("john.smith@mailinator.com")
                        .withFirstName("John")
                        .withLastName("Smith")
                        .deliverSignedDocumentsByEmail() )
                .withDocument(newDocumentWithName("First Document")
                        .fromStream( documentInputStream1, DocumentType.PDF )
                        .withSignature(signatureFor("john.smith@mailinator.com")
                                .onPage(0)
                                .atPosition(100, 100)))
                .build();

Running Your Code

Once you’ve sent your package for signing and the package has been completed, the screenshot below shows the email your signer(s) can expect:

capture

Get the Code

Once a package (transaction in the UI) has been completed, you can automatically deliver signed documents to your signers.

The Code

Below is a sample code on how to build your Signer object in order to deliver signed documents by email once the transaction has been completed.

DocumentPackage package = PackageBuilder.NewPackageNamed(PackageName)
                    .DescribedAs("This is a new package")
                    .WithSigner(SignerBuilder.NewSignerWithEmail(email1)
                                .WithFirstName("John")
                                .WithLastName("Smith")
                                .DeliverSignedDocumentsByEmail())
                    .WithDocument(DocumentBuilder.NewDocumentNamed("My Document")
                                  .FromStream(fileStream1, DocumentType.PDF)
                                  .WithSignature(SignatureBuilder.SignatureFor(email1)
                                   .OnPage(0)
                                   .AtPosition(100, 100)))
                    .Build();

Running Your Code

Once you’ve sent your package for signing and the package has been completed, the screenshot below shows the email your signer(s) can expect:

capture

Get the Code

Once a package (transaction in the UI) has been completed, you can automatically deliver signed documents to your signers.

The Code

Below is a sample request on how to build your signer object in order to deliver signed documents by email once the transaction has been completed.

HTTP Request
POST /api/packages/{packageId}/roles

HTTP Headers
Accept: application/json
Content-Type: application/json
Authorization: Basic api_key

Request Payload

{
  "id": "Signer5",
  "reassign": true,
  "type": "SIGNER",
  "signers": [
    {
      "email": "mail32@mailinator.com",
      "firstName": "John",
      "lastName": "Smith",
      "id": "Signer5",
      "delivery": {
        "email": true,
        "download": true,
        "provider": true
      }
    }
  ],
  "name": "Signer5"
}

For a complete description of each field, take a look at the JSON Properties section below.

Response Payload

{
    "id": "Signer5",
    "data": null,
    "specialTypes": [],
    "emailMessage": null,
    "attachmentRequirements": [],
    "locked": false,
    "reassign": true,
    "index": 0,
    "signers": [
        {
            "group": null,
            "language": "en",
            "signature": null,
            "id": "Signer5",
            "delivery": {
                "provider": true,
                "email": true,
                "download": true
            },
            "auth": {
                "scheme": "NONE",
                "challenges": []
            },
            "knowledgeBasedAuthentication": null,
            "data": null,
            "title": "",
            "company": "",
            "email": "mail32@mailinator.com",
            "firstName": "John",
            "lastName": "Smith",
            "external": null,
            "updated": "2017-11-16T16:53:01Z",
            "phone": "",
            "professionalIdentityFields": [],
            "userCustomFields": [],
            "address": null,
            "created": "2017-11-16T16:53:01Z",
            "name": "",
            "specialTypes": []
        }
    ],
    "name": "Signer5",
    "type": "SIGNER"
}

Running Your Code

Once you’ve sent your package for signing and the package has been completed, the screenshot below shows the email your signer(s) can expect:

capture

Get the Code

JSON Properties

Property Type Editable Required Default Sample Value(s)
id string Yes No n/a Signer5
reassign boolean Yes No false true / false
name string Yes No n/a Signer5
id string Yes No n/a Signer5
type string Yes No SIGNER SIGNER / SENDER
signers
email string Yes No n/a mail32@mailinator.com
firstName string Yes No n/a John
lastName string Yes No n/a Smith
id string Yes No n/a Signer5
delivery
email boolean Yes No false true / false
download boolean Yes No false true / false
provider boolean Yes No false true / false

Once a package (transaction in the UI) has been completed, you can automatically deliver signed documents to your signers.

The Code

Below is a sample code on how to build your Role object in order to deliver signed documents by email once the transaction has been completed.

ESignLiveAPIObjects.Role role = new ESignLiveAPIObjects.Role();
        
ESignLiveAPIObjects.Signer signer = new ESignLiveAPIObjects.Signer();
signer.firstName = 'firstName';
signer.lastName = 'lastName';
signer.email = 'signer@example.com';
signer.name = 'signer1';
signer.id = 'signer1';
signer.delivery = new ESignLiveAPIObjects.Delivery(true,true,true);	//Boolean download, Boolean email, Boolean provider
        
role.signers = new List<ESignLiveAPIObjects.Signer>{signer};
role.id = 'signer1';

Running Your Code

Once you’ve sent your package for signing and the package has been completed, the screenshot below shows the email your signer(s) can expect:

capture

Get the Code