Hyperlink fields

Hyperlink field - a type of field which contains a URL.

To add a Hyperlink field to a document, make a PUT /document/.../{document_id} request, open fields array in the request body, add a field and specify its "type" parameter as "hyperlink".

{
  "fields": [
    {
      "page_number": 0,
      "type": "hyperlink",
      "name": "HyperlinkName",
      "role": "Signer 1",
      "label": "HyperlinkLabel",
      "required": true,
      "link": "<http://signnow.com>",
      "hint": "signnow.com",
      "height": 35,
      "width": 31,
      "x": 10,
      "y": 10
    }
  ]
}

Here’s a response example when a Hyperlink field has been added to the document*.

*In this example we show the response to a GET .../document/{document_id} request. The response to a PUT .../document/{document_id} is only a document ID, e.g. "id": "3db38d8c1fdfca762b25d57d82b3cf327a65485e".

{
  "hyperlinks": [],
  "fields": [
    {
      "id": "ccbd8ecde5074f2a9669ceed2c4aad6d9296af07",
      "type": "hyperlink",
      "role_id": "ed1fe6496119438081b464f15e47557837626908",
      "json_attributes": {
        "page_number": 0,
        "x": 10,
        "y": 10,
        "width": 31,
        "height": 35,
        "required": true,
        "name": "HyperlinkName",
        "label": "HyperlinkLabel",
        "link": "http://signnow.com",
        "hint": "signnow.com"
      },
      "role": "Signer 1",
      "originator": "document_owner@signnow.com",
      "fulfiller": "signer1@gmail.com",
      "field_request_id": "3bb1bbf2607f489299f1c57b1ffd29509809d831",
      "element_id": null,
      "field_request_canceled": null,
      "template_field_id": null,
      "field_id": "3bb1bbf2607f489299f1c57b1ffd29509809d831"
    }
  ]
}

When a Signer fills in the Hyperlink field and submits the document, the response contains the "hyperlinks" array where you can find the URL as the "data" parameter value.

{
  "hyperlinks": [
    {
      "id": "68803ee370e54ad4b322414d9eca5a9d37e30a91",
      "user_id": "a954c1e8a45ff6bb0d233d8ac160bd4e3271ca94",
      "page_number": "0",
      "email": "signer1@gmail.com",
      "font": "Arial",
      "size": "8",
      "data": "http://signnow.com",
      "label": "HyperlinkLabel",
      "x": "234",
      "y": "15",
      "line_height": "9.00",
      "created": "1581419110"
    }
  ],
  "fields": [
    {
      "id": "ccbd8ecde5074f2a9669ceed2c4aad6d9296af07",
      "type": "hyperlink",
      "role_id": "ed1fe6496119438081b464f15e47557837626908",
      "json_attributes": {
        "page_number": 0,
        "x": 10,
        "y": 10,
        "width": 31,
        "height": 35,
        "required": true,
        "name": "HyperlinkName",
        "label": "HyperlinkLabel",
        "link": "http://signnow.com",
        "hint": "signnow.com"
      },
      "role": "Signer 1",
      "originator": "document_owner@signnow.com",
      "fulfiller": "signer1@gmail.com",
      "field_request_id": "3bb1bbf2607f489299f1c57b1ffd29509809d831",
      "element_id": "68803ee370e54ad4b322414d9eca5a9d37e30a91",
      "field_request_canceled": null,
      "template_field_id": null,
      "field_id": "3bb1bbf2607f489299f1c57b1ffd29509809d831"
    }
  ]
}