The SignNow API Documentation

For full documentation and an evaluation Application ID and access, please contact api@signnow.com.

Create an account for the first user:

Make a POST /user call (example using curl):

curl -ssl3 -H 'Authorization: Basic ENCODED_CLIENT_CREDENTIALS' --data '{"first_name":"FIRST","last_name":"LAST","email":"USER_1_EMAIL","password":"USER_1_PASSWORD"}' https://capi-eval.signnow.com/api/user

Make a note of the access token you receive. (USER_1_ACCESS_TOKEN)

Create a document for the first user:

POST /document (accepts .doc, .docx, .pdf, .png filetypes)

curl -ssl3 -H 'Authorization: Bearer USER_1_ACCESS_TOKEN' -F 'file=@FILE_NAME' https://capi-eval.signnow.com/api/document

Make a note of the document id that is returned in the JSON response. (USER_1_DOCUMENT_ID)

As the first user, invite the second user to sign the document you created:

Make a POST /document/<DOCUMENT_ID>/invite call, with email=disable to suppress the delivery of an email invite:

curl -ssl3 -H 'Authorization: Bearer USER_1_ACCESS_TOKEN' --data '{"from":"USER_1_EMAIL","to":"USER_2_EMAIL"}' https://capi-eval.signnow.com/api/document/USER_1_DOCUMENT_ID/invite?email=disable


Generate a signing link:

The base URL for the link is: https://eval.signnow.com/dispatch?route=asign

The link requires these query parameters: document_id and access_token

For document_id, use the invited but unsigned USER_2_DOCUMENT_ID.

Get an access_token with a scope specific to that document by making a GET /oauth2/token request.

curl -ssl3 -H 'Authorization: Basic ENCODED_CLIENT_CREDENTIALS' --data 'username=USER_2_EMAIL&password=USER_2_PASSWORD&grant_type=password&scope=document/USER_2_DOCUMENT_ID%20document/USER_2_DOCUMENT_ID/*%20user%20user/signature' https://capi-eval.signnow.com/api/oauth2/token

This returns USER_2_RESTRICTED_ACCESS_TOKEN

Generate the full signing link:

https://eval.signnow.com/dispatch?route=asign&document_id=USER_2_DOCUMENT_ID&access_token=USER_2_RESTRICTED_ACCESS_TOKEN

The signing link accepts optional query parameters:

   redirect_uri
   theme
   disable_email

To use a nuetral theme, send the user to a simple thank you page after they’ve completed the signing session successfully, and suppress the sending of the signed document via email add this item to the query string:

redirect_uri=%2Fdocument-saved-successfully&theme=neutral&disable_email=true

The full link will then be:

https://eval.signnow.com/dispatch?route=asign&document_id=USER_2_DOCUMENT_ID&access_token=USER_2_RESTRICTED_ACCESS_TOKEN&redirect_uri=%2Fdocument-saved-successfully&theme=neutral&disable_email=true

View the Signing Session page to see this link embedded in a signing session.