curl -X POST 'https://api.sendforsign.com/api/placeholder' \
     -H 'Authorization: Bearer 123456789' \
     -H 'Content-Type: application/json' \
     -d '{
    "data": {
        "action": "update",
        "contractKey": "CONTRACT_KEY",
        "placeholders": [
            {
                "placeholderKey": "RECIPIENT_KEY_4",
                "isSpecial": true,
                "specialType": 4,
                "insertion": [
                    {
                        "action": "update",
                        "id": 2,
                        "pageId": 0,
                        "width": 150,
                        "height": 150,
                        "positionX": 1,
                        "positionY": 1
                    }
                ]
            }
        ]
    }
}'
{
    "code": 201,
    "message": "Placeholder updated"
}
Special placeholders are four types of placeholders that are created automatically for every recipient. So, before placing special fields in your PDF contract, create a recipient using this request. After this, all the special placeholders will be created automatically with corresponding keys: Recipient_Key_1, Recipient_Key_2, Recipient_Key_3, Recipient_Key_4. Here’s an example of a placeholder key: "placeholderKey": "93447fb5-91ee-41ad-9f73-b4ae2d467292_4". Available placeholder codes:
  • 1: Recipient’s date signed.
  • 2: Recipient’s full name.
  • 3: Recipient’s email.
  • 4: Recipient’s signature.

Body parameters

action
string
required
Action type.
contractKey
string
required
ID of the contract.
placeholders
required
Array of placeholders.

Response

placeholder
string
Placeholder structure.
code
string
The code of the answer.
message
string
The message of the answer.
curl -X POST 'https://api.sendforsign.com/api/placeholder' \
     -H 'Authorization: Bearer 123456789' \
     -H 'Content-Type: application/json' \
     -d '{
    "data": {
        "action": "update",
        "contractKey": "CONTRACT_KEY",
        "placeholders": [
            {
                "placeholderKey": "RECIPIENT_KEY_4",
                "isSpecial": true,
                "specialType": 4,
                "insertion": [
                    {
                        "action": "update",
                        "id": 2,
                        "pageId": 0,
                        "width": 150,
                        "height": 150,
                        "positionX": 1,
                        "positionY": 1
                    }
                ]
            }
        ]
    }
}'
{
    "code": 201,
    "message": "Placeholder updated"
}