Skip to main content
A signature place marks a specific location in a document where a recipient draws or types their signature. Each signature place is linked to one recipient through the recipient_key. A single recipient can have multiple signature places across different pages of a document. You can position signature places using either placeholders or fixed positions. The width of a signature place is calculated automatically using a 5:2 ratio based on the height.

​
Attributes

​
type
enum
required
Specifies the type of place.For a signature place, the value must be signature.
​
key
string
required
A unique identifier for this place within the document. Use this key to match the place to its position, either through a [[place_key]] placeholder in the document or an entry in fixed_positions.Must start with a lowercase letter and contain only lowercase letters, numbers, and underscores. Maximum 32 characters.
​
recipient_key
string
required
The key of the recipient assigned to this place. Must match one of the key values in the envelope’s recipients array.
​
height
number
The height of the signature place in . The width is calculated automatically using a 5:2 ratio based on this height.Must be between 20 and 60. Defaults to 60.

​
Examples

"documents": [
  {
    //...
    "places": [
      {
        "key": "employer_first_signature",
        "type": "signature",
        "recipient_key": "employer",
        "height": 60
      }
    ]
    //...
  }
]