SignNow

Send documents for e-signature with SignNow from a workflow: upload a document from a link, fill in its text fields, and invite one signer or several roles in order, or hand out a signing link instead. Follow or cancel the invites, get a download link to the signed PDF, file documents in folders, and make new documents from templates.

Actions

Action	What it does
Cancel a freeform invite	Withdraw one freeform invite so it can no longer be signed.
Cancel field invites	Withdraw every field invite out on a document, so a new one can be sent.
Create a document from a template	Make a new document from a template, with its fields and roles, ready to fill in and send.
Create a folder	Make a new folder inside an existing one.
Create a signing link	Make a shareable link that opens a document ready to sign, instead of emailing an invite.
Create a template	Save a document's layout, fields and roles as a template, so new documents can be made from it.
Delete a document	Delete a document or a template from the account.
Delete a folder	Delete a folder.
Fill in text fields	Write text into a document's text fields before sending it: a client's name, an amount, a date.
Get a document	Read a document: its roles, its fields, and every field invite out on it with its status (pending, fulfilled, canceled or skipped).
Get a download link	A link anyone can use to download the document as a PDF.
Get a folder	List the documents in a folder, optionally only those at one signing stage.
Get my account	Read the SignNow account this connection acts as: its email, name and document counts.
List folders	Every folder in the account, nested ones included, with its path and how many documents it holds.
List freeform invites	The freeform invites sent for one document, each pending, fulfilled or canceled.
Move a document	File a document in another folder.
Search documents	Find documents and document groups by name, id, sender, signer or the text inside them, most recently updated first.
Send a field invite	Ask each role on a document to fill in and sign its own fields, in signing order.
Send a freeform invite	Ask one person to sign a document that has no fields; they place their own signature wherever it is needed.
Upload a document from a URL	Have SignNow fetch a document from a public link (PDF, Word, an image and most office formats, up to 50 MB) into the Documents folder.

Cancel a freeform invite

Withdraw one freeform invite so it can no longer be signed.

Inputs

Invite IDinvite_idtextRequired: From 'Send a freeform invite' or 'List freeform invites'.
Reasonreasontext: Why, for the record. Up to 1,000 characters.

Outputs

cancelledtrue/false
invite_idtext
reasontext

Example output

{
  "cancelled": true,
  "invite_id": "c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f701234567",
  "reason": null
}

Cancel field invites

Withdraw every field invite out on a document, so a new one can be sent.

Inputs

Document IDdocument_idtextRequired: The document's id, or a SignNow link to it. An 'Upload a document' or 'Search documents' step returns one.
ReasonreasontextRequired: Why. SignNow requires one.

Outputs

cancelledtrue/false
document_idtext
reasontext

Example output

{
  "cancelled": true,
  "document_id": "a1b2c3d4e5f60718293a4b5c6d7e8f9012345678",
  "reason": "Terms changed"
}

Create a document from a template

Make a new document from a template, with its fields and roles, ready to fill in and send. The copy has new field and role ids.

Inputs

Template IDtemplate_idtextRequired: The template's id, or a SignNow link to it.
Document namedocument_nametext: The template's name if left blank.

Outputs

idtext
nametext
template_idtext

Example output

{
  "id": "a1b2c3d4e5f60718293a4b5c6d7e8f9012345678",
  "name": "Service agreement \u2014 Acme",
  "template_id": "7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f"
}

Create a folder

Make a new folder inside an existing one.

Inputs

NamenametextRequired: What to call the folder.
Insideparent_folder_idtextRequired: The folder to create it in, usually Documents.

Outputs

idtext
nametext
parent_idtext

Example output

{
  "id": "f0e1d2c3b4a5968778695a4b3c2d1e0f12345678",
  "name": "Contracts",
  "parent_id": "38ab01cd23ef45ab67cd89ef01ab23cd45ef6789"
}

Create a signing link

Make a shareable link that opens a document ready to sign, instead of emailing an invite. The document needs at least one role that does not already have a fixed e-mail on it.

Inputs

Document IDdocument_idtextRequired: The document's id, or a SignNow link to it. An 'Upload a document' or 'Search documents' step returns one.
Signer first namefirstnametext: Shown in the signing page's welcome message.
Signer last namelastnametext: Shown in the signing page's welcome message.
Redirect URLredirect_uritext: Where the signer lands once every requested field is signed.

Outputs

document_idtext
urltext
url_no_signuptext
url_no_signup_qrcodetext
url_qrcodetext

Example output

{
  "document_id": "a1b2c3d4e5f60718293a4b5c6d7e8f9012345678",
  "url": "https://app.signnow.com/webapp/document/link/abc123",
  "url_no_signup": "https://app.signnow.com/webapp/document/link/abc123?no_signup=1",
  "url_no_signup_qrcode": "https://app.signnow.com/webapp/document/link/abc123/qr?no_signup=1",
  "url_qrcode": "https://app.signnow.com/webapp/document/link/abc123/qr"
}

Create a template

Save a document's layout, fields and roles as a template, so new documents can be made from it. SignNow builds the template by flattening the document.

Inputs

Document IDdocument_idtextRequired: The document's id, or a SignNow link to it. An 'Upload a document' or 'Search documents' step returns one.
Template nametemplate_nametextRequired: What to call the template.

Outputs

idtext
nametext
source_document_idtext

Example output

{
  "id": "7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f",
  "name": "Service agreement",
  "source_document_id": "a1b2c3d4e5f60718293a4b5c6d7e8f9012345678"
}

Delete a document

Delete a document or a template from the account.

Inputs

Document IDdocument_idtextRequired: The document's id, or a SignNow link to it. An 'Upload a document' or 'Search documents' step returns one.

Outputs

deletedtrue/false
document_idtext

Example output

{
  "deleted": true,
  "document_id": "a1b2c3d4e5f60718293a4b5c6d7e8f9012345678"
}

Delete a folder

Delete a folder. SignNow does not document what happens to documents inside it, so move or delete them first.

Inputs

Folderfolder_idtextRequired: Pick a folder, or paste its id.

Outputs

deletedtrue/false
folder_idtext

Example output

{
  "deleted": true,
  "folder_id": "f0e1d2c3b4a5968778695a4b3c2d1e0f12345678"
}

Fill in text fields

Write text into a document's text fields before sending it: a client's name, an amount, a date. Only text fields can be filled this way.

Inputs

Document IDdocument_idtextRequired: The document's id, or a SignNow link to it. An 'Upload a document' or 'Search documents' step returns one.
Field namefield_nametext: The text field to fill in.
Texttexttext: What to write into it.
More fieldsmore_fieldsobject: Any other fields to fill: field name → text.

Outputs

countnumber
document_idtext
fieldslist

Example output

{
  "count": 1,
  "document_id": "a1b2c3d4e5f60718293a4b5c6d7e8f9012345678",
  "fields": [
    {
      "field_name": "Client name",
      "text": "Acme Inc"
    }
  ]
}

Get a document

Read a document: its roles, its fields, and every field invite out on it with its status (pending, fulfilled, canceled or skipped).

Inputs

Document IDdocument_idtextRequired: The document's id, or a SignNow link to it. An 'Upload a document' or 'Search documents' step returns one.

Outputs

createdtext
field_inviteslist
fieldslist
folder_idtext
idtext
is_templatetrue/false
nametext
original_filenametext
ownertext
page_countnumber
roleslist
signature_countnumber
text_field_nameslist
updatedtext

Example output

{
  "created": "2026-09-18T09:00:00Z",
  "field_invites": [
    {
      "created": "2026-09-18T09:00:00Z",
      "email": "signer@example.com",
      "expires": "2026-10-18T09:00:00Z",
      "id": "c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f701234567",
      "role": "Signer 1",
      "role_id": "48ab01cd23ef45ab67cd89ef01ab23cd45ef6789",
      "status": "pending",
      "updated": "2026-09-18T09:00:00Z"
    }
  ],
  "fields": [
    {
      "id": "d8ab01cd23ef45ab67cd89ef01ab23cd45ef6789",
      "name": "Client name",
      "required": true,
      "role": "Signer 1",
      "role_id": "48ab01cd23ef45ab67cd89ef01ab23cd45ef6789",
      "type": "text"
    }
  ],
  "folder_id": "f0e1d2c3b4a5968778695a4b3c2d1e0f12345678",
  "id": "a1b2c3d4e5f60718293a4b5c6d7e8f9012345678",
  "is_template": false,
  "name": "Service agreement.pdf",
  "original_filename": "Service agreement.pdf",
  "owner": "you@example.com",
  "page_count": 2,
  "roles": [
    {
      "id": "48ab01cd23ef45ab67cd89ef01ab23cd45ef6789",
      "name": "Signer 1",
      "signing_order": 1
    }
  ],
  "signature_count": 0,
  "text_field_names": [
    "Client name"
  ],
  "updated": "2026-09-18T09:05:00Z"
}

Get a download link

A link anyone can use to download the document as a PDF. It works once: after the first download, ask for a new one.

Inputs

Document IDdocument_idtextRequired: The document's id, or a SignNow link to it. An 'Upload a document' or 'Search documents' step returns one.

Outputs

document_idtext
linktext

Example output

{
  "document_id": "a1b2c3d4e5f60718293a4b5c6d7e8f9012345678",
  "link": "https://api.signnow.com/document/a1b2c3d4e5f60718293a4b5c6d7e8f9012345678/download"
}

Get a folder

List the documents in a folder, optionally only those at one signing stage. This is how SignNow lists documents.

Inputs

Folderfolder_idtextRequired: Pick a folder, or paste its id.
Signing statussigning_statustext: Only documents at this stage.One of: signed, pending, waiting-for-me (Waiting for me), waiting-for-others (Waiting for others), unsent (Not sent yet), expired.
Sort bysort_bytext: SignNow's own order if left blank.One of: updated (Last updated), created, document-name (Document name).
Orderordertext: Only used with Sort by.One of: desc (Newest / Z first), asc (Oldest / A first).
How manylimitnumber: Up to 100.From 1 to 100.
Skipoffsetnumber: How many documents to skip, for paging.At least 0.

Outputs

countnumber
documentslist
folderslist
idtext
nametext
parent_idtext
total_documentsnumber

Example output

{
  "count": 1,
  "documents": [
    {
      "created": "2026-09-18T09:00:00Z",
      "field_invite_count": 1,
      "id": "a1b2c3d4e5f60718293a4b5c6d7e8f9012345678",
      "is_template": false,
      "name": "Service agreement.pdf",
      "owner": "you@example.com",
      "page_count": 2,
      "roles": [
        "Signer 1"
      ],
      "signature_count": 0,
      "updated": "2026-09-18T09:05:00Z"
    }
  ],
  "folders": [],
  "id": "f0e1d2c3b4a5968778695a4b3c2d1e0f12345678",
  "name": "Documents",
  "parent_id": "38ab01cd23ef45ab67cd89ef01ab23cd45ef6789",
  "total_documents": 1
}

Get my account

Read the SignNow account this connection acts as: its email, name and document counts. The email is the only address SignNow will send invites from.

Inputs

None.

Outputs

activetrue/false
createdtext
document_countnumber
emailtext
emailslist
first_nametext
idtext
last_nametext
lifetime_document_countnumber
monthly_document_countnumber
organization_idtext
organization_nametext

Example output

{
  "active": true,
  "created": "2026-09-01T09:00:00Z",
  "document_count": 12,
  "email": "you@example.com",
  "emails": [
    "you@example.com"
  ],
  "first_name": "Ada",
  "id": "89ab01cd23ef45ab67cd89ef01ab23cd45ef6789",
  "last_name": "Lovelace",
  "lifetime_document_count": 40,
  "monthly_document_count": 3,
  "organization_id": "",
  "organization_name": ""
}

List folders

Every folder in the account, nested ones included, with its path and how many documents it holds. Also returns the ids of the root, Documents and Templates folders.

Inputs

None.

Outputs

countnumber
documents_folder_idtext
folderslist
root_folder_idtext
templates_folder_idtext

Example output

{
  "count": 1,
  "documents_folder_id": "f0e1d2c3b4a5968778695a4b3c2d1e0f12345678",
  "folders": [
    {
      "document_count": 12,
      "folder_count": 1,
      "id": "f0e1d2c3b4a5968778695a4b3c2d1e0f12345678",
      "name": "Documents",
      "path": "Documents",
      "shared": false,
      "team_name": "",
      "template_count": 0
    }
  ],
  "root_folder_id": "38ab01cd23ef45ab67cd89ef01ab23cd45ef6789",
  "templates_folder_id": "25ab01cd23ef45ab67cd89ef01ab23cd45ef6789"
}

List freeform invites

The freeform invites sent for one document, each pending, fulfilled or canceled.

Inputs

Document IDdocument_idtextRequired: The document's id, or a SignNow link to it. An 'Upload a document' or 'Search documents' step returns one.
How many per pageper_pagenumber: Up to 100.From 1 to 100.
Pagepagenumber: Which page to return, starting at 1.At least 1.

Outputs

countnumber
has_moretrue/false
itemslist
pagenumber
totalnumber
total_pagesnumber

Example output

{
  "count": 1,
  "has_more": false,
  "items": [
    {
      "created": "2026-09-18T09:00:00Z",
      "email": "signer@example.com",
      "id": "c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f701234567",
      "status": "pending"
    }
  ],
  "page": 1,
  "total": 1,
  "total_pages": 1
}

Move a document

File a document in another folder.

Inputs

Document IDdocument_idtextRequired: The document's id, or a SignNow link to it. An 'Upload a document' or 'Search documents' step returns one.
Folderfolder_idtextRequired: Pick a folder, or paste its id.

Outputs

document_idtext
folder_idtext
movedtrue/false

Example output

{
  "document_id": "a1b2c3d4e5f60718293a4b5c6d7e8f9012345678",
  "folder_id": "f0e1d2c3b4a5968778695a4b3c2d1e0f12345678",
  "moved": true
}

Search documents

Find documents and document groups by name, id, sender, signer or the text inside them, most recently updated first. At most 1,000 results in all. A newly uploaded document can take a moment to become searchable.

Inputs

Search forsearch_keytextRequired: What to look for. Emails need at least 2 characters and document text at least 3; shorter searches find nothing rather than failing.
Search insearch_bytext: Which details to match. Name if left blank.One or more of: name (Document name), id (Document ID), inviter-email (Sender's email), signer-email (Signer's email), document-text (Text inside the document).
How many per pageper_pagenumber: Up to 20.From 1 to 20.
Pagepagenumber: Which page to return, starting at 1.At least 1.

Outputs

countnumber
has_moretrue/false
itemslist
pagenumber
totalnumber
total_pagesnumber

Example output

{
  "count": 1,
  "has_more": false,
  "items": [
    {
      "created": "2026-09-18T09:00:00Z",
      "entity_type": "document",
      "folder_id": "f0e1d2c3b4a5968778695a4b3c2d1e0f12345678",
      "id": "a1b2c3d4e5f60718293a4b5c6d7e8f9012345678",
      "name": "Service agreement.pdf",
      "owner": "you@example.com",
      "page_count": 2,
      "roles": [
        "Signer 1"
      ],
      "updated": "2026-09-18T09:05:00Z"
    }
  ],
  "page": 1,
  "total": 1,
  "total_pages": 1
}

Send a field invite

Ask each role on a document to fill in and sign its own fields, in signing order. The document needs fields and roles: upload it with 'Turn text tags into fields' ticked, or make it from a template. Returns the invites created.

Inputs

Document IDdocument_idtextRequired: The document's id, or a SignNow link to it. An 'Upload a document' or 'Search documents' step returns one.
Signer's emailsigner_emailtextRequired: Who signs for the role below.
Signer rolesigner_roletextRequired: Their role on the document, e.g. 'Signer 1'.
Signing ordersigning_ordernumber: 1 signs first. Signers with the same number sign in any order.From 1 to 100.
More signersmore_signerslist: One entry per other role: email, role and order.
Fromfrom_emailtext: Leave blank to send from this SignNow account. SignNow only accepts the account's own login email here.
CCcclist: Email addresses to copy on the invite.
Expires after (days)expiration_daysnumber: 30 if left blank.From 3 to 180.
First reminder after (days)remind_after_daysnumber: Must be sooner than the expiry.From 1 to 179.
Then remind every (days)remind_every_daysnumber: Up to 7.From 1 to 7.
Languagelanguagetext: The language of the signing page and the invite email. Blank uses the account's language.One of: en (English), es (Spanish), fr (French).
Redirect URL after signingredirect_uritext: Where to send each signer once they sign.
Redirect URL after decliningdecline_redirect_uritext: Where to send a signer who declines.
Open the redirect inredirect_targettext: Only used when a redirect URL is set.One of: blank (A new tab), self (The same tab).
Subject (paid plans)subjecttext: A custom email subject needs a paid SignNow API plan, an API free trial or a Site License. Leave blank otherwise.
Message (paid plans)messagetext: Same plan requirement as the subject.

Outputs

countnumber
document_idtext
fromtext
inviteslist

Example output

{
  "count": 1,
  "document_id": "a1b2c3d4e5f60718293a4b5c6d7e8f9012345678",
  "from": "you@example.com",
  "invites": [
    {
      "created": "2026-09-18T09:00:00Z",
      "email": "signer@example.com",
      "expires": "2026-10-18T09:00:00Z",
      "id": "c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f701234567",
      "role": "Signer 1",
      "role_id": "48ab01cd23ef45ab67cd89ef01ab23cd45ef6789",
      "status": "pending",
      "updated": "2026-09-18T09:00:00Z"
    }
  ]
}

Send a freeform invite

Ask one person to sign a document that has no fields; they place their own signature wherever it is needed. For a document with fields, use 'Send a field invite'.

Inputs

Document IDdocument_idtextRequired: The document's id, or a SignNow link to it. An 'Upload a document' or 'Search documents' step returns one.
Signer's emailtotextRequired: Who should sign.
Fromfrom_emailtext: Leave blank to send from this SignNow account. SignNow only accepts the account's own login email here.
CCcclist: Email addresses to copy on the invite.
Subjectsubjecttext: The invite email's subject. SignNow's own if blank.
Messagemessagetext: The invite email's message. SignNow's own if blank.
Languagelanguagetext: The language of the signing page and the invite email. Blank uses the account's language.One of: en (English), es (Spanish), fr (French).
Redirect URLredirect_uritext: Where to send the signer after they sign.
Open the redirect inredirect_targettext: Only used when a redirect URL is set.One of: blank (A new tab), self (The same tab).

Outputs

callback_urltext
document_idtext
fromtext
idtext
totext

Example output

{
  "callback_url": "none",
  "document_id": "a1b2c3d4e5f60718293a4b5c6d7e8f9012345678",
  "from": "you@example.com",
  "id": "c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f701234567",
  "to": "signer@example.com"
}

Upload a document from a URL

Have SignNow fetch a document from a public link (PDF, Word, an image and most office formats, up to 50 MB) into the Documents folder.

Inputs

File URLurltextRequired: A public link straight to the file. A sharing page that needs a sign-in will not work.
Turn text tags into fieldscheck_fieldstrue/false: Tick if the document contains SignNow text tags such as {{t:s;r:y;o:"Signer 1";}}. They become fillable fields and roles, which a field invite needs.Default: false.

Outputs

check_fieldstrue/false
idtext
source_urltext

Example output

{
  "check_fields": false,
  "id": "a1b2c3d4e5f60718293a4b5c6d7e8f9012345678",
  "source_url": "https://example.com/contract.pdf"
}

ActionsCopy Anchor Link

Cancel a freeform inviteCopy Anchor Link

Inputs

Outputs

Cancel field invitesCopy Anchor Link

Inputs

Outputs

Create a document from a templateCopy Anchor Link

Inputs

Outputs

Create a folderCopy Anchor Link

Inputs

Outputs

Create a signing linkCopy Anchor Link

Inputs

Outputs

Create a templateCopy Anchor Link

Inputs

Outputs

Delete a documentCopy Anchor Link

Inputs

Outputs

Delete a folderCopy Anchor Link

Inputs

Outputs

Fill in text fieldsCopy Anchor Link

Inputs

Outputs

Get a documentCopy Anchor Link

Inputs

Outputs

Get a download linkCopy Anchor Link

Inputs

Outputs

Get a folderCopy Anchor Link

Inputs

Outputs

Get my accountCopy Anchor Link

Inputs

Outputs

List foldersCopy Anchor Link

Inputs

Outputs

List freeform invitesCopy Anchor Link

Inputs

Outputs

Move a documentCopy Anchor Link

Inputs

Outputs

Search documentsCopy Anchor Link

Inputs

Outputs

Send a field inviteCopy Anchor Link

Inputs

Outputs

Send a freeform inviteCopy Anchor Link

Inputs

Outputs

Upload a document from a URLCopy Anchor Link

Inputs

Outputs

On this page

Actions

Cancel a freeform invite

Cancel field invites

Create a document from a template

Create a folder

Create a signing link

Create a template

Delete a document

Delete a folder

Fill in text fields

Get a document

Get a download link

Get a folder

Get my account

List folders

List freeform invites

Move a document

Search documents

Send a field invite

Send a freeform invite

Upload a document from a URL