Create Signing Field

View as Markdown

Headers

{{tenant_key_name}}stringOptional

Request

This endpoint expects a multipart form.
widthstringRequired

Required: Field width in PDF points - numeric > 0

heightstringRequired

Required: Field height in PDF points - numeric > 0

field_typestringRequired

Required: Field type - in: SIGNATURE|INITIAL|DATE|TEXT|CHECKBOX

position_xstringRequired

Required: X coordinate in PDF points from page top-left - numeric >= 0

position_ystringRequired

Required: Y coordinate in PDF points from page top-left - numeric >= 0

field_labelstringRequired

Required: Human-readable label - max 255 chars

field_orderstringRequired

Optional: Tab-order within the page - integer >= 0

is_requiredstringRequired

Optional: Recipient must complete - boolean true|false|1|0

page_numberstringRequired

Required: PDF page number - integer >= 1

default_valuestringRequired

Optional: Default value - DATE supports literal TODAY token (auto-fills with submit-time UTC date) - max 1000 chars

document_signer_idstringRequired

Required: Owning signer UUID - exists:document_signers,id

Response

Successful response