Place special placeholder

curl -X POST 'https://api.sendforsign.com/api/placeholder' \
     -H 'X-Sendforsign-Key: YOUR_API_KEY' \
     -H 'Content-Type: application/json' \
     -d '{
    "data": {
        "action": "update",
        "clientKey": "YOUR_CLIENT_KEY",
        "contractKey": "CONTRACT_KEY",
        "placeholders": [
            {
                "placeholderKey": "RECIPIENT_KEY_4",
                "isSpecial": true,
                "specialType": 4,
                "insertion": [
                    {
                        "action": "update",
                        "clientKey": "YOUR_CLIENT_KEY",
                        "id": 2,
                        "pageId": 0,
                        "width": 150,
                        "height": 150,
                        "positionX": 1,
                        "positionY": 1
                    }
                ]
            }
        ]
    }
}'

{
    "code": 201,
    "message": "Placeholder updated"
}

POST

api

placeholder

curl -X POST 'https://api.sendforsign.com/api/placeholder' \
     -H 'X-Sendforsign-Key: YOUR_API_KEY' \
     -H 'Content-Type: application/json' \
     -d '{
    "data": {
        "action": "update",
        "clientKey": "YOUR_CLIENT_KEY",
        "contractKey": "CONTRACT_KEY",
        "placeholders": [
            {
                "placeholderKey": "RECIPIENT_KEY_4",
                "isSpecial": true,
                "specialType": 4,
                "insertion": [
                    {
                        "action": "update",
                        "clientKey": "YOUR_CLIENT_KEY",
                        "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

data

object

required

Show child attribute

action

string

required

Action type.

clientKey

string

required

Key of the client.

contractKey

string

required

Key of the contract.

placeholders

array

required

Array of placeholders.

Show child attribute

placeholderKey

string

required

Key of the placeholder that needs to be updated. Generated automatically from 2 paramaters: Recipient’s Key and Special Type.

isSpecial

boolean

required

True for special fields.

specialType

string

required

Use the following placeholder codes to create the corresponding fields: 1: Recipient’s date signed, 2: Recipient’s full name 3: Recipient’s email 4: Recipient’s signature

insertion

array

Array of places.

Show child attribute

string

ID of the insertion. Provide a new ID for each insertion. If you provide the ID of an existing placeholder, the placeholder will be updated.

pageId

string

Page number where you insert the placeholder, starting from 0.

width

string

Width of the placeholder.

height

string

Height of the placeholder.

positionX

string

Position X of the placeholder, starting from the top-left corner of the page.

positionY

string

Position Y of the placeholder, starting from the top-left corner of the page.

Response

placeholder

string

Placeholder structure.

Show child attribute

createTime

string

Create time.

changeTime

string

Change time.

code

string

The code of the answer.

message

string

The message of the answer.

curl -X POST 'https://api.sendforsign.com/api/placeholder' \
     -H 'X-Sendforsign-Key: YOUR_API_KEY' \
     -H 'Content-Type: application/json' \
     -d '{
    "data": {
        "action": "update",
        "clientKey": "YOUR_CLIENT_KEY",
        "contractKey": "CONTRACT_KEY",
        "placeholders": [
            {
                "placeholderKey": "RECIPIENT_KEY_4",
                "isSpecial": true,
                "specialType": 4,
                "insertion": [
                    {
                        "action": "update",
                        "clientKey": "YOUR_CLIENT_KEY",
                        "id": 2,
                        "pageId": 0,
                        "width": 150,
                        "height": 150,
                        "positionX": 1,
                        "positionY": 1
                    }
                ]
            }
        ]
    }
}'

{
    "code": 201,
    "message": "Placeholder updated"
}

Place basic placeholder List of placeholders

API Documentation

MCP

Client

User

Contract

PDF and Word

Placeholder

Recipient

Template

Webhook

Settings

Body parameters

Response

​Body parameters

​Response

Body parameters

Response