Add a signature date field

A field is the object that bears the action to be performed by a participant. A field has a type which can be either:

• signature (for a signature request by a physical person),
• visa (for a consultation request by a physical person),
• text (for a text field to be filled by the participant),
• label (for a read only text added by the transaction creator on a document),
• checkbox_group (for a group of checkboxes to be checked by the participant),
• checkbox (for a checkbox to be checked by the participant),
• radio_group (for a group of radio buttons to be checked by the participant),
• radiobutton (for a radio button to be checked by the participant),
• dropdown (for a dropdown list where the participant needs to select an option).
• image (for an image field where the participant needs to import an image file),
• signature_date (for a field that displays the date and hour when the participant signed the document),
• full_name (for a field that displays the participant full name),
• email (for a field that displays the participant email),
• company_name (for a field that displays the participant company name),
• job_title (for a field that displays the participant job title).

You can also add initials fields.

About signature date fields

A signature date field allows you to display the date and hour when the participant signed the document. By default, only the signature date displays in the field. However, you can edit the date format to include the time the participant signed the document.

Note that you can’t add signature date fields:

• on a document that has already been processed by a participant,
• on a document that already contains a signature (before being imported to the transaction).

Create a signature date field

To create a signature date field, send a request to POST /v1/transactions/{transaction_id}/documents/{document_id}/fields and pass signature_date in the type argument.

You can set other optional arguments:

curl
https://api.universign.com/v1/transactions/tx_DwYGle91EQZA/documents/doc_4dn/fields \
-d type=signature_date \
-d format=DD/MM/YYYY \
-d page=1 \
-d x=328 \
-d y=580 \
-d width=200 \
-d height=19

• name: The signature date field name.
• page: The page number on which you want to position the signature date field.
• x: The signature date field horizontal coordinate on the document page (in pixels).
• y: The signature date field vertical coordinate on the document page (in pixels).
• copy_from: Use to copy the field. Expected value is the ID of the field you want to copy. This creates a new field with no position on the document. Do not pass if you pass the move_from argument.
• move_from: Use to move a field to another document. Expected value is the ID of the field you want to move. Do not pass if you pass the copy_from argument.
• height: The height of the field (expressed in PDF’s default user space units). Default value is 19.
• width: The width of the field (expressed in PDF’s default user space units). Default value is 200.
• font_size: The font size of the field content. Possible values between 7 and 12. Default value is 12.
• format: The signature date format you want to display. Possible values are as follows:
  • DD/MM/YYYY (e.g. 31/01/2026)
  • MM/DD/YYYY (e.g. 01/31/2026)
  • YYYY/MM/DD (e.g. 2026/01/31)
  • DD MMM YYYY (e.g. 31 Jan 2026)
  • MMM DD, YYYY (e.g. Jan 31, 2026)
  • dddd DD MMMM YYYY (e.g. Saturday 31 January 2026)
  • dddd MMMM DD, YYYY (e.g. Saturday January 31, 2026)

Note that if you want to display signature time as well, append HH:mm to the format value (eg. DD/MM/YYYY - HH:mm).

The API response returns a field sub-object.

{
  "id" : "fld_4zlL",
  "type" : "signature_date",
  "position" : {
    "page" : 1,
    "x" : 328,
    "y" : 580,
    "width" : 200,
    "height" : 19
  },
  "font_size" : 12,
  "updatable" : true,
  "deletable" : false,
  "format" : "DD/MM/YYYY",
  "required" : false,
  "built_in" : false
}

Update a signature date field

To update a signature date field, send a request to POST /v1/transactions/{transaction_id}/documents/{document_id}/fields/{field_id}.

curl
https://api.universign.com/v1/transactions/tx_DwYGle91EQZA/documents/doc_4dn/fields \
-d type=signature_date \
-d format=DD/MM/YYYY - hh:mm \
-d page=2 \
-d x=200 \
-d y=200 \
-d width=250 \
-d height=35

The API response returns a field sub-object as it was last updated.

{
  "id" : "fld_4zlL",
  "type" : "signature_date",
  "position" : {
    "page" : 2,
    "x" : 200,
    "y" : 200,
    "width" : 250,
    "height" : 35
  },
  "font_size" : 12,
  "updatable" : true,
  "deletable" : false,
  "format" : "DD/MM/YYYY - HH:mm",
  "required" : true,
  "built_in" : false
}

---

Add initials fields

← Previous

Add a full name automatic field

Next →