Recipient Email Place let you insert the email address of the recipient, as identified by the recipient_key, at a location in the document.

You can position recipient name places inside a document using either fixed positions or placeholders.

Example

For example, this is a definition of a recipient email place for the recipient with key client, linked to the placeholder client_email inside the document:

"documents":
[
  {
    "places": [
      {
        "key": "client_email",
        "type": "recipient_email",
        "recipient_key": "client"
      },
      //...
    ]
    //...
  }
]

Parameters

type
enum
required

Specifies the type of place.

For this kind of place, the value must be recipient_email.

key
string
required

A user-provided key that identifies a place within a document.

It must be up to 32 characters long, using only lowercase letters, numbers, or underscores, and it must begin with a letter.

recipient_key
string
required

A user-provided key that identifies a recipient within an envelope.

It must match to one of the keys in the envelope’s recipient list.