Initials Place – SignatureAPI Docs

An initials place marks a specific location in a document where a recipient enters their initials. Each initials place is linked to one recipient through the recipient_key. A single recipient can have multiple initials places across different pages.

You can position initials places using either placeholders or fixed positions.

The width of an initials place equals its height (a square field).

Attributes

type

enum

required

Specifies the type of place.

For an initials place, the value must be initials.

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 initials place in . The width equals the height.

Must be between 20 and 60. Defaults to 60.

Examples

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