Signature positioning
Use Fixed Positions to Position Signatures
Position a signature place at exact page coordinates in points, measured to the bottom-left corner of the place, for documents with a fixed layout.
In SignatureAPI, places are areas in a document where recipients sign, enter information, or where details, such as dates, are automatically added. The signature place is one of such places.
There are two ways to position places: fixed positions (coordinates) and placeholders within the document. In this example, we will show how to position a signature place using fixed positions.
For this example, we will create an envelope with:
- One recipient (of type
signer), identified with the keyvisitor. - The visitor signs a single PDF document.
- The document will have one signature place, identified with the key
signer_signs_here, that will be signed by the recipientvisitorand will be added during the envelope creation using fixed positions.
All other envelope settings use the default configuration:
- The recipient will receive an email with a link to sign.
- The account’s default language, timezone, and timestamp format used.
Prepare your Document
Start with a PDF or DOCX file. You can reference it by a public URL, as in this example, or upload it to SignatureAPI and use the upload URL.
For this example, we prepared a document with a signature line on the second page.
Example document
Download the PDF used in this example.
Locate the Coordinates
A fixed position is a page number plus two distances: from the top edge of the page (top) and from the left edge (left), in points (1 point = 1/72 inch). Both distances point to the bottom-left corner of the place. The place extends up and to the right from there, so to sit a signature on a line, use the line’s position as top and the line’s start as left.
One of the main problems when using Fixed Positions is finding the exact coordinates. You can use any tool that indicates the position in points like image editors, or build your own. For this task, SignatureAPI provides a simple tool that helps, just open the file and click on the point you want.
The key of the place will be signer_signs_here, and the position will be available at the sidebar.
Create the Envelope
When creating the envelope, add the array of fixed positions inside the document, and add the signature place object to the places array inside the document object, with the following properties:
key: Identifies the place within the document. Must match what you decided to use, in this case:signer_signs_here.type: As this is a signature place, use the valuesignature.recipient_key: The key of the recipient who will sign. Here, it’svisitor.
POST /v1/envelopes HTTP/1.1
Host: api.signatureapi.com
X-API-Key: YOUR_API_KEY
Content-Type: application/json
{
"title": "Privacy Consent",
"message": "Please review and sign the privacy consent.",
"documents": [
{
"url": "https://pub-9cb75390636c4a8a83a6f76da33d7f45.r2.dev/privacy-fixed.pdf",
"format": "pdf",
"fixed_positions": [
{
"place_key": "signer_signs_here",
"page": 2,
"top": 471,
"left": 73
}
],
"places": [
{
"key": "signer_signs_here",
"type": "signature",
"recipient_key": "visitor"
}
]
}
],
"recipients": [
{
"type": "signer",
"key": "visitor",
"name": "Jane Doe",
"email": "jane.doe@example.com"
}
]
}Result
If successful, SignatureAPI sends Jane Doe (the recipient) an email with a link to sign. Jane opens the link and signs on the signature line.
Try It
Try this example in Postman (“Create an envelope with fixed positions”) using your test API key to create a free, non-binding test envelope. Test envelopes don’t send emails, but you can review them in the Dashboard.
Keep Learning
- Learn how to position a signature using placeholders within the document.
- Explore other types of places, such as initials, text inputs, or completion dates.