Skip to main content
POST
/
sign
/
envelopes
/
{envelopeID}
/
documents
/
{documentID}
/
fields
Create Field by Document ID
curl --request POST \
  --url https://api.gonitro.dev/sign/envelopes/{envelopeID}/documents/{documentID}/fields \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "boundingBox": [
    123
  ],
  "participantID": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "type": "checkbox",
  "page": 123,
  "required": true
}
'
{
  "type": "signature",
  "boundingBox": [
    123
  ],
  "participantID": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "documentID": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "page": 123,
  "required": true,
  "ID": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
envelopeID
string<uuid>
required

A unique string that identifies the envelope in the Nitro system.

​
documentID
string<uuid>
required

A unique string that identifies the document in the Nitro system.

Body

application/json
  • Checkbox
  • Company
  • Custom
  • Date
  • Initials
  • Name
  • Signature
  • Title

Parameters to create a Checkbox field

​
boundingBox
number<float>[]
required

An array of numbers in the format [x, y, w, h] that defines the field’s bounding box on the page:

  • x, y are the coordinates of the top-left corner, measured in points (pt).
  • w, h are the width and height of the bounding box, also in points (pt).

For more information on calculating positions, see the Bounding Box Guide.

Required array length: 4 elements
​
participantID
string<uuid>
required

The unique identifier of the participant assigned to the field. Fields can only be created for participants with the signer role.

​
type
enum<string>
required
Available options:
checkbox
​
page
integer<int32>

The page number where the field appears. Pages follow 1-based indexing, so the first page is 1.

​
required
boolean

A boolean that indicates whether the participant must complete the field.

Response

Field created successfully

  • Checkbox
  • Company
  • Custom
  • Date
  • Initials
  • Name
  • Signature
  • Title

Create Checkbox Field Response

​
type
enum<string>
required

Enum that specifies which type of information an eSignature participant is expected to fill in.

Available options:
signature,
name,
checkbox,
date,
initials,
company,
title,
custom
​
boundingBox
number<float>[]
required

An array of numbers in the format [x, y, w, h] that defines the field’s bounding box on the page:

  • x, y are the coordinates of the top-left corner, measured in points (pt).
  • w, h are the width and height of the bounding box, also in points (pt).

For more information on calculating positions, see the Bounding Box Guide.

Required array length: 4 elements
​
participantID
string<uuid>
required

The unique identifier of the participant assigned to the field. Fields can only be created for participants with the signer role.

​
documentID
string<uuid>
required

ID of the document to which this field belongs.

​
page
integer<int32>

The page number where the field appears. Pages follow 1-based indexing, so the first page is 1.

​
required
boolean

A boolean that indicates whether the participant must complete the field.

​
ID
string<uuid>

Unique ID of the field