How can I sign a document myself and share the signed copy with my stakeholders?

The Sign Yourself option, also known as Self Sign, helps users upload and sign documents and then send the signed copies to one or more recipients in documents like self declaration form, certificates, etc.

All you have to is upload the document ,set the parameter self_sign = true, add the necessary document fields, and sign the document.

Sample request - Create document

Copiedcurl --location 'https://sign.zoho.com/api/v1/requests' \
--header 'Authorization: Zoho-oauthtoken 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa' \
--form 'file=@Path to file'\
--form 'data="{
  "requests": {
    "request_name": "Self declaration form",
    "self_sign": true
  }
}"' \

Sample response

Copied{
  "code": 0,
  "requests": {
    "request_status": "draft",
    "notes": "",
    "reminder_period": 5,
    "owner_id": "33942000000037003",
    "description": "",
    "request_name": "Self declaration form",
    "modified_time": 1761209662607,
    "is_deleted": false,
    "expiration_days": 15,
    "is_sequential": false,
    "templates_used": [],
    "owner_first_name": "John",
    "sign_percentage": 0,
    "owner_email": "john.martin@securesign24x7.com",
    "created_time": 1761209662607,
    "email_reminders": true,
    "document_ids": [
      {
        "image_string": "/UUAFFFFABRRRQA//Z",
        "document_name": "test",
        "pages": [
          {
            "image_string": "/9/4AAQSkZJRgABAgAAAQABAAD/Z",
            "page": 0,
            "is_thumbnail": true
          }
        ],
        "document_size": 3489518,
        "document_order": "0",
        "is_nom151_present": false,
        "is_editable": false,
        "is_html_content_present": false,
        "total_pages": 9,
        "document_id": "33942000000224002"
      }
    ],
    "self_sign": true,
    "document_fields": [
      {
        "document_id": "33942000000224002",
        "fields": []
      }
    ],
    "allow_add_comments": true,
    "in_process": false,
    "validity": -1,
    "request_type_name": "Others",
    "request_id": "33942000000224001",
    "request_type_id": "33942000000000187",
    "owner_last_name": "Martin",
    "actions": [
      {
        "verify_recipient": false,
        "recipient_countrycode_iso": "",
        "action_type": "SIGN",
        "cloud_provider_name": "Zoho Sign",
        "recipient_email": "john.martin@securesign24x7.com",
        "send_completed_document": true,
        "recipient_phonenumber": "",
        "is_bulk": false,
        "action_id": "33942000000224016",
        "signing_order": -1,
        "cloud_provider_id": 10,
        "recipient_name": "John Martin",
        "fields": [],
        "delivery_mode": "EMAIL",
        "action_status": "NOACTION",
        "is_signing_group": false,
        "recipient_countrycode": ""
      }
    ]
  },
  "message": "Document has been added",
  "status": "success"
}

Sample request - Signing document

Copiedcurl --location --request POST 'https://sign.zoho.com/api/v1/requests/<request-id>/sign' \
--header 'Authorization: Zoho-oauthtoken 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'data={
  "requests": {
    "actions": [
      {
        "action_id": "33942000000224099",
        "fields": [
          {
            "field_type_id": "33942000000000047",
            "field_type_name": "Signature",
            "action_id": "33942000000224099",
            "is_mandatory": true,
            "x_coord": 166,
            "abs_height": 19,
            "field_category": "image",
            "field_label": "Signature",
            "page_no": 0,
            "document_id": "33942000000224085",
            "is_draggable": false,
            "field_name": "Signature",
            "y_value": 41.199043,
            "abs_width": 28,
            "width": 4.710406,
            "y_coord": 347,
            "description_tooltip": "",
            "x_value": 27.896594,
            "is_resizable": true,
            "height": 2.26981
          },
          {
            "field_type_id": "33942000000000053",
            "field_type_name": "Textfield",
            "action_id": "33942000000224099",
            "field_value": "Zoho Institute of Technology",
            "text_property": {
              "font": "Roboto",
              "font_size": 11,
              "font_color": "000000",
              "is_bold": false,
              "is_italic": false,
              "is_underline": false,
              "is_fixed_height": true,
              "is_read_only": false,
              "is_fixed_width": false,
              "alignment": "LEFT",
              "max_field_length": 2048
            },
            "is_mandatory": true,
            "field_name": "",
            "field_label": "College Name",
            "field_category": "textfield",
            "description_tooltip": "",
            "abs_width": 98,
            "abs_height": 14,
            "validation": {
              "validation_type": "NONE"
            },
            "x_value": "57.344748",
            "y_value": "71.690751",
            "page_no": 8,
            "document_id": "33942000000224085",
            "width": "12.747510",
            "height": "1.728827"
          }
        ],
        "verify_recipient": false,
        "recipient_countrycode_iso": "",
        "action_type": "SIGN",
        "cloud_provider_name": "Zoho+Sign",
        "recipient_email": "john.martin@securesign24x7.com",
        "send_completed_document": true,
        "recipient_phonenumber": "",
        "is_bulk": false,
        "signing_order": -1,
        "cloud_provider_id": 10,
        "recipient_name": "John Martin",
        "delivery_mode": "EMAIL",
        "recipient_countrycode": "",
        "deleted_fields": []
      }
    ],
    "deleted_actions": [],
    "request_name": "Self declaration form"
  }
}'

Response example

Copied{   "request_status": "completed",
    "code": 0,
    "message": "Document signed successfully",
    "status": "success"
}