How to add different signer fields to your recipients?
This section says how to set different types of fields supported in Zoho Sign.
Image category fields
Signature field
- Signature of the signer can be collected.
- Signers can draw, upload, type (in the case of guest signer), or fetch their signature from their Zoho Sign profile. Learn more
{
"requests": {
"actions": [
{
"fields": [
{
"field_type_name": "Signature",
"action_id": "14197000001428004",
"document_id": "14197000001427002",
"field_name": "Signature",
"width": "22.045264",
"height": "2.461140",
"x_value": "68.499843",
"y_value": "84.132124",
"page_no": 0,
"field_category": "image",
"field_label": "Signature"
}
]
}
]
}
}
Show full
Show less
Initial field
You can use initial fields in instances where there is a space constraint for the signature field to be placed.
{
"requests": {
"actions": [
{
"fields": [
{
"field_type_name": "Initial",
"field_label": "Initial"
}
]
}
]
}
}
Image field
Signer can upload an image.
{
"requests": {
"actions": [
{
"fields": [
{
"field_type_name": "Image",
"field_label": "Image"
}
]
}
]
}
}
Stamp field
- Signer can either drag and drop or upload the document /image containing the company's stamp.
- Click here to learn how to add your organization logo to your Zoho Sign profile.
{
"requests": {
"actions": [
{
"fields": [
{
"field_type_name": "Stamp",
"field_label": "Stamp"
}
]
}
]
}
}
Text category fields
Text field
- Use this to accept any type of character as an input.
- However, when data validation is enforced, it ensures that the sender gets the right input from the signer.
{
"requests": {
"actions": [
{
"fields": [
{
"field_type_name": "Textfield",
"action_id": "14197000001428004",
"document_id": "14197000001427002",
"field_name": "Text Field",
"width": "16.010059",
"height": "1.683938",
"x_value": "30.779809",
"y_value": "17.357513",
"page_no": 0,
"field_category": "textfield",
"field_label": "Text",
"text_property": {
"font": "Roboto",
"font_size": 11,
"font_color": "000000",
"is_bold": false,
"is_italic": false,
"max_field_length": 2048
}
}
]
}
]
}
}
Show full
Show less
Company field
- The signer can enter their company details, or if the signer is a Zoho Sign customer, the details can be auto-fetched from their profile.
Click here to learn how to set up organization details in your Zoho Sign profile.
{
"requests": {
"actions": [
{
"fields": [
{
"field_type_name": "Company",
"field_label": "Company"
}
]
}
]
}
}
Name field
- Signer's full name/first name/last name can be obtained.
- The signer's name gets auto-fetched from the recipient details entered by the sender, but can be edited by the signer.
{
"requests": {
"actions": [
{
"fields": [
{
"field_type_name": "Name",
"name_format": "FULL_NAME",
"field_label": "Full Name"
}
]
}
]
}
}
Email field
- Sender can get their signer's email address in the document with this field.
- Once the signer clicks this field, the email address is auto fetched and cannot be edited.
{
"requests": {
"actions": [
{
"fields": [
{
"field_type_name": "Email",
"field_label": "Email"
}
]
}
]
}
}
Job title field
Similar to text field, but if the signer has added their job title, that information will be auto fetched while document signing.
{
"requests": {
"actions": [
{
"fields": [
{
"field_type_name": "Jobtitle",
"field_label": "Job title"
}
]
}
]
}
}
Date category fields
Date field (Custom date)
- This can be used wherever the sender wants a value related to date in their document.
- The entry could be either a past date or a future date.field_category to be set as "datefield" and date_format param to be passed.
{
"requests": {
"actions": [
{
"fields": [
{
"field_type_name": "CustomDate",
"action_id": "14197000001428004",
"document_id": "14197000001427002",
"field_name": "Date",
"width": "16.010059",
"height": "1.683938",
"x_value": "19.631444",
"y_value": "12.240933",
"page_no": 0,
"date_format": "MMM-dd-yyyy",
"field_category": "datefield",
"field_label": "Date",
"text_property": {
"font": "Roboto",
"font_size": 11,
"font_color": "000000",
"is_bold": false,
"is_italic": false
}
}
]
}
]
}
}
Show full
Show less
Checkbox category fields
Signer can choose from multiple options provided by the sender.
{
"requests": {
"actions": [
{
"fields": [
{
"field_type_name": "Checkbox",
"action_id": "14197000001428004",
"document_id": "14197000001427002",
"field_name": "Checkbox",
"width": "1.927913",
"height": "1.489637",
"x_value": "69.338066",
"y_value": "11.917098",
"page_no": 0,
"field_category": "checkbox",
"field_label": "Checkbox"
}
]
}
]
}
}
Show full
Show less
Dropdown category fields
You can have your signer choose an option from the list of options provided by the sender.
{
"requests": {
"actions": [
{
"fields": [
{
"field_type_name": "Dropdown",
"action_id": "14197000001428004",
"document_id": "14197000001427002",
"field_name": "Dropdown",
"width": "16.010059",
"height": "1.683938",
"x_value": "80.431423",
"y_value": "11.595288",
"page_no": 0,
"field_category": "dropdown",
"field_label": "Dropdown",
"dropdown_values": [
{
"dropdown_value": "Dropdown Value 0",
"dropdown_order": 0
},
{
"dropdown_value": "Dropdown Value 1",
"dropdown_order": 1
},
{
"dropdown_value": "Dropdown Value 2",
"dropdown_order": 2
}
],
"text_property": {
"font": "Roboto",
"font_size": 11,
"font_color": "000000",
"is_bold": false,
"is_italic": false
}
}
]
}
]
}
}
Show full
Show less
Radio group category fields
The signer can choose only one option from the options provided by the sender.
{
"requests": {
"actions": [
{
"fields": [
{
"field_type_name": "Radiogroup",
"action_id": "14197000001428004",
"document_id": "14197000001427002",
"field_name": "Radiogroup",
"field_category": "radiofield",
"field_label": "Radiogroup",
"sub_fields": [
{
"sub_field_name": "Option+1",
"width": "1.960784",
"height": "1.515036",
"x_value": "91.412144",
"y_value": "17.098446",
"page_no": 0
},
{
"sub_field_name": "Option+2",
"width": "1.960784",
"height": "1.515036",
"x_value": "91.412144",
"y_value": "19.113482",
"page_no": 0
},
{
"sub_field_name": "Option+3",
"width": "1.960784",
"height": "1.515036",
"x_value": "91.440905",
"y_value": "21.606995",
"page_no": 0
}
]
}
]
}
]
}
}
Show full
Show less
Attachment category fields
You can have your recipient add attachments upto 10 MB. The attachment will be present at the end of the document.
{
"requests": {
"actions": [
{
"fields": [
{
"field_type_name": "Attachment",
"action_id": "14197000001428004",
"document_id": "14197000001427002",
"field_name": "Attachment",
"width": "16.010059",
"height": "2.137306",
"x_value": "19.04468",
"y_value": "8.031088",
"page_no": 0,
"field_category": "filefield",
"field_label": "Attachment"
}
]
}
]
}
}
Show full
Show less
Payment category fields
You must have integrated with Zoho Checkout and must have sent the document with payment field from Zoho Sign's UI before using this API.
{
"requests": {
"actions": [
{
"fields": [
{
"field_type_name": "Checkout",
"action_id": "14197000001428004",
"document_id": "14197000001427002",
"field_name": "Payment",
"width": "16.010059",
"height": "1.683938",
"x_value": "48.717781",
"y_value": "38.147668",
"page_no": 0,
"date_format": "MMM-dd-yyyy",
"field_category": "payment",
"field_label": "Payment",
"amount": "100",
"currency_code": "INR",
"form_id": "102660000000104380",
"org_id": "68019648",
"text_property": {
"font": "Roboto",
"font_size": 11,
"font_color": "000000",
"is_bold": false,
"is_italic": false
}
}
]
}
]
}
}
Show full
Show less