Email Message

The following guide shows you an example of how to customize the e-mail message received by a signer when a package is sent for signing.

When sending packages for signing, you can add an additional message in the e-mail your signers receive.

The Code

You can add specific messages for each signer in the e-mail they receive after you’ve sent your package. Below is an example on how to build your Signer object with a customized e-mail message.

DocumentPackage pkg = PackageBuilder.newPackageNamed("Example Package")
    .withSigner(SignerBuilder.newSignerWithEmail("mail45@mailinator.com")
        .withFirstName("John")
        .withLastName("Smith")
        .withCustomId("signer1")
        .withEmailMessage("Please sign the documents ASAP."))
    .withDocument(DocumentBuilder.newDocumentWithName("Sample contract")
        .atIndex(0)
        .fromFile("C:/Users/hhaidary/Desktop/PDFs/sample_contract.pdf")
        .withSignature(SignatureBuilder.signatureFor("mail45@mailinator.com")
            .atPosition(100, 100)
            .onPage(0)))
     .build();

Running Your Code

Below is a screenshot of what your signers can expect in the e-mail they receive:

capture

Get the Code

When sending packages for signing, you can add an additional message in the e-mail your signers receive.

The Code

You can add specific messages for each signer in the e-mail they receive after you’ve sent your package. Below is an example on how to build your Signer object with a customized e-mail message.

DocumentPackage package = PackageBuilder.NewPackageNamed("Example Package")
    .WithSigner(SignerBuilder.NewSignerWithEmail("mail45@mailinator.com")
        .WithFirstName("John")
        .WithLastName("Smith")
        .WithCustomId("signer1")
        .WithEmailMessage("Please sign the documents ASAP."))
    .WithDocument(DocumentBuilder.NewDocumentNamed("Sample contract")
        .AtIndex(0)
        .FromFile(@"C:/Users/hhaidary/Desktop/PDFs/sample_contract.pdf")
        .WithSignature(SignatureBuilder.SignatureFor("mail45@mailinator.com")
            .AtPosition(100, 100)
            .OnPage(0)))
        .Build();

Running Your Code

Below is a screenshot of what your signers can expect in the e-mail they receive:

capture

Get the Code

When sending packages for signing, you can add an additional message in the e-mail your signers receive.

The Code

You can add specific messages for each signer in the e-mail they receive after you’ve sent your package. Below is an example on how to build your “roles” object with a customized e-mail message.

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

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

Request Payload

{
  "emailMessage": {
    "content": "Please sign the documents ASAP."
  },
  "id": "Signer5",
  "reassign": true,
  "type": "SIGNER",
  "signers": [
    {
      "email": "mail32@mailinator.com",
      "firstName": "John",
      "lastName": "Smith",
      "id": "Signer5"
    }
  ],
  "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": {
    "content": "Please sign the documents ASAP."
  },
  "attachmentRequirements": [],
  "locked": false,
  "reassign": true,
  "index": 0,
  "signers": [
    {
      "group": null,
      "language": "en",
      "signature": null,
      "id": "Signer5",
      "delivery": {
        "provider": false,
        "email": false,
        "download": false
      },
      "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

Below is a screenshot of what your signers can expect in the e-mail they receive:

capture

Get the Code

JSON Properties

Property Type Editable Required Default Sample Value(s)
id string Yes No n/a Signer5
emailMessage
content string Yes No n/a Please sign the documents ASAP.
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