The SignNow API Documentation

For full documentation and an evaluation Application ID and access, please contact

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"}'

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'

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"}'

Generate a signing link:

The base URL for the link is:

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'


Generate the full signing link:

The signing link accepts optional query parameters:


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:


The full link will then be:

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