SignNow
SignNow REST Service Wrapper
☝️ The SignNow package has been upgraded to 1.2.0 and moved to https://www.npmjs.com/package/@signnow/api-client.
The version 1.1.8 is no longer supported. If you have questions about the SignNow API, please visit https://help.signnow.com/docs or email api@signnow.com.
Updates
12/3/2015 - The eval server has been changed to api-eval.signnow.com. You will need to create a new account for api-eval.signnow.com. https://eval.signnow.com.
About SignNow
SignNow is a powerful web-based e-signature solution that streamlines the signing process and overall document flow for businesses of any size. SignNow offers SaaS as well as public and private cloud deployment options using the same underlying API. With SignNow you can easily sign, share and manage documents in compliance with international data laws and industry-specific regulations. SignNow enables you to collect signatures from partners, employees and customers from any device within minutes.
API Contact Information
If you have questions about the SignNow API, please visit https://help.signnow.com/docs or email api@signnow.com.
See additional contact information at the bottom.
Installation
$ npm install signnow
Examples
To run the examples you will need an API key. You can get one here https://www.signnow.com/api. For a full list of accepted parameters, refer to the SignNow REST Endpoints API guide: https://help.signnow.com/docs.
Every resource is accessed via your SignNow instance:
var signnow = credentials: "ENCODED_CLIENT_CREDENTIALS" production: false //(false uses eval server);
Every resource returns two parameters. The first param contains any errors and the second contains the results.
User
Create a User
signnowuser;
Retrieve User Information
signnowuser;
OAuth 2.0
Request Access Token
signnowoauth2;
Verify an Access Token
signnowoauth2;
Document
Retrieve a List of the User’s Documents
signnowdocument;
Retrieve a Document Resource
signnowdocument;
Download a Collapsed Document
signnowdocument;
Upload Document
signnowdocument;
Upload File & Extract Fields
signnowdocument;
Update Document (add fields)
var fieldsObj = "texts": "size":8 "x":61 "y":72 "page_number":0 "font":"Arial" "data":"sample text" "line_height":9075 signnowdocument;
Create Invite to Sign a Document
signnowdocument;
Cancel an Invite to a Document
signnowdocument;
Create a One-time Use Download URL
signnowdocument;
Merges Existing Documents
signnowdocument;
Get Document History
signnowdocumenthistory token: "your login token" id: "document id" { if!err console; else console; };
Enumerations
Add Enumeration Field to a Document
signnowenumerations;
Add Enumeration Options to the Field
signnowenumerations;
Template
Create a Template
signnowtemplate;
Duplicate a Template
signnowtemplate;
Folder
Returns a list of folders
signnowfolder;
Returns a list of documents inside a folder
Filters | Values |
---|---|
signing-status |
waiting-for-me , waiting-for-others , signed , pending |
document-updated |
new Date() |
document-created |
new Date() |
Sort | Values |
---|---|
document-name |
asc /desc |
updated |
asc /desc |
created |
asc /desc |
signnowfolder;
Webhook
Returns a list of Webhooks
signnowwebhook;
Create a Webhook
Events | Description |
---|---|
document.create |
Webhook is triggered when a document is uploaded to users account in SignNow |
document.update |
Webhook is triggered when a document is updated (fields added, text added, signature added, etc.) |
document.delete |
Webhook is triggered when a document is deleted from |
invite.create |
Webhook is triggered when an invitation to a SignNow document is created. |
invite.update |
Webhook is triggered when an invite to SignNow document is updated. Ex. A signer has signed the document. |
signnowwebhook;
Unit Tests
To run the unit test you will need to install "Mocha" and "Chai". You also need to create a "test.settings.js" in the root of the SignNow module. The file will need to contain the following:
{ "use strict"; /** * Test Settings */ exportssettings = credentials: "[ENCODED CLIENT CREDENTIALS]" token: "[ACCESS TOKEN]" username: "[SIGNNOW USERNAME]" password: "[SIGNNOW PASSWORD]" documentid: "[EXISTING DOCUMENT ID]" templateid: "[EXISTING TEMPLATE ID]" folderid: "[EXISTING FOLDER ID]" email: "[FROM EMAIL FOR INVITE]" testemail: "[TO EMAIL FOR INVITE]" ; };
Additional Contact Information
SUPPORT
To contact SignNow support, please email support@signnow.com.
SALES
For pricing information, please call (800) 831-2050 or email sales@signnow.com.