Skip to main content
curl -X POST 'https://api.sendforsign.com/api/placeholder' \
     -H 'Authorization: Bearer 123456789' \
     -H 'Content-Type: application/json' \
     -d '{
    "data": {
        "action": "create",
        "contractKey": "CONTRACT_KEY",
        "placeholder": {
            "name": "Placeholder name",
            "value": "Placeholder value"
        }
    }
}'

{
    "placeholder": {
        "id": "3",
        "createTime": "2024-11-22T11:11:24.000Z",
        "changeTime": "2024-11-22T11:11:24.000Z",
        "name": "1",
        "value": "hello",
        "type": "1",
        "placeholderKey": "PLACEHOLER_KEY",
        "position": "3"
    },
    "code": 201,
    "message": "Placeholder created"
}
One way to add placeholders to a contract is when you create a new contract. See this page to learn more. If a contract already exists, use the request below.

​
Body parameters

​
action
string
required
Action type.
​
contractKey
string
required
ID of the contract.
​
placeholder
required
Structure, add the fields that need to be updated and ignore the rest.

​
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": "create",
        "contractKey": "CONTRACT_KEY",
        "placeholder": {
            "name": "Placeholder name",
            "value": "Placeholder value"
        }
    }
}'

{
    "placeholder": {
        "id": "3",
        "createTime": "2024-11-22T11:11:24.000Z",
        "changeTime": "2024-11-22T11:11:24.000Z",
        "name": "1",
        "value": "hello",
        "type": "1",
        "placeholderKey": "PLACEHOLER_KEY",
        "position": "3"
    },
    "code": 201,
    "message": "Placeholder created"
}
⌘I