- Electronic Signature
- Release notes
Release notes signNow API
Learn about signNow’s latest updates and releases.
Embedded view
Create a link to provide access to a document in embedded view mode. This mode enables users to review and download documents without logging in to SignNow. Embedded view links can only be generated for Documents and Document Groups.
Pre-fill Document Group parameters for embedded sending
Customize how you send Document Groups from your app by pre-filling parameters such as recipient roles, recipient email addresses, CC’d recipients, and invite email subjects and messages.
Two-factor signer authentication for embedded Document Group invites
Two-factor signer authentication is now available for Document Groups to enhance the security of embedded signing.
iFrame authorization
Simplify SignNow login from your system using embedded iFrame authorization.
Verification emails
Send a verification email to the new user. Once they click the link in the email, their account will be verified.
New branding attributes
Documentation links:
Custom fields
Set up custom fields and reuse them in any document or template to prepare eSignature invites faster.
Please note that you can only create and configure custom fields using the SignNow user interface.
QES for embedded Document and Document Group workflows
Request Qualified Electronic Signatures (QES) using embedded invites.
Documentation links:
Template sharing
The owner of a template can:
See the documentation links above for more details.
CC email branding
Customize the branding of emails for CC'd recipients separately from others.
Document Group editing
Reorder documents and set actions upon their completion (e.g., email documents and attachments to all parties).
Note: A Document Group cannot have any pending or completed signature invites.
Document Group Template editing
Reorder documents, set actions upon their completion (e.g., email documents and attachments to all parties), or rename a Document Group Template.
New endpoints:
Access token termination
Remove the current access token from an authorization header. The token will no longer be available for bearer authentication.
Webhooks updates
Qualified Electronic Signature user guide updates
Qualified Electronic Signature: Bulk Invites
Send three types of requests for signing documents with Qualified Electronic Signatures (QES):
To use this feature, a user must be a member of an Organization with QES settings enabled.
Get an authorization code
Create an authorization code that allows you to generate a bearer token without using SignNow account credentials.
Complete Document Group correction
Edit Document Group invites:
Qualified electronic signature (QES)
A qualified electronic signature uses a qualified digital certificate and provides the highest level of assurance with face-to-face identity verification. Such signatures are recognized as carrying the same legal weight as handwritten signatures.
Send two types of QES-compatible eSignature invites:
New videos in the API documentation
Develop eSignature integrations faster with new video guides that are now available in the documentation. Find those videos in the following chapters:
Retrieve smart fields from the ‘GET document’ call response
Added a new query parameter: include=integration_objects
When applied, the response will contain the list of smart fields.
New endpoints for Organization branding
Users can create multiple brands for a single Organization. If a user is a part of an Organization, they can apply their personal brands and the brands of their Organization to documents, Document Groups, and applications. Only administrators and moderators of an Organization are permitted to create and modify Organization brands.
The new endpoints enable users to create, retrieve, update, and delete a brand for their Organization, as well as its resources. Find the available endpoints in the documentation.
Sample app for embedded signing (built with the PHP SDK)
The sample application demonstrates how to use the eSignature API and PHP SDK to build embedded signing workflows. Consider using the sample app for testing or as a basis for your own application.
The sample app was built using the PHP SDK.
Try embedding a signing session into your website or application with the repository provided by this link.
Webhooks: Get the list of callbacks
Retrieve the list of all webhook events (events history).
The results can be filtered and sorted. If a sorting parameter is not specified, the results are sorted in descending order by ‘start_time’.
Webhooks: Activate/Deactivate/Update/Delete event subscriptions
Added endpoints for event subscription management:
Get a list of Document Groups created from a Document Group Template
Retrieve a list of all Document Groups created and sent from a specific Document Group Template.
Get a list of Document Group Template recipients
Retrieve a list of recipients for a specific Document Group Template.
Organizations: Generate a file with login data
Added an endpoint that allows an Organization Admin to obtain a CSV file with login data for a selected date range. The file is delivered via email.
Organizations: Generate a file with user activity data
Added an endpoint that allows an Organization Admin or Moderator to obtain a CSV file with user activity data for a selected date range. The file is delivered via email.
Move a Document Group to another folder
When you move a Document Group, all its documents will be transferred to the same folder, except for those in the Deleted folder (Deleted from Trash) and shared folders.
Accessibility for the ‘Create editor brand’ resource
Added the accessibility.enabled attribute to the ‘Create editor brand’ resource payload.
Move a Document Group Template
Send a Document Group Template to the Templates subfolder or to the Trash folder.
New documentation chapter: Embedded editor
Find all the information you need about embedded editing in one place.
New documentation chapter: Embedded signing
Find all the information you need about embedded signing in one place.
Email a Document Group copy
Send a copy of a Document Group to a specific email address. The recipient can then view or download their document copies. A Document Group copy can be sent by either an owner, signer, or viewer of the Document Group.
CC text tags
Use a text tag to include a recipient in the carbon copy list for a specific document.
New documentation chapter: Invite to Sign
Find all the information you need about sending eSignature invites in one place.
Added the “ip_address” attribute for the ‘Get document history’ endpoint
Retrieve a full history of a Document Group by a specific IP address.
Added the “entity_type” attribute for the ‘Get folder’ endpoints
Specify the types of documents you require from a particular folder to be included in the response (e.g., Document / Document Group / Template, etc.).
Documentation links:
Added the “email_groups” attribute for Document Group Invites
Send a Document Group for eSignature to multiple recipients at once (an email group). An email group may contain several email addresses, and every recipient within a group will receive an eSignature invite. As soon as any of the designated recipients signs a Document Group, the signing session is completed.
Create webhooks in the API UI
Set up webhooks directly from your account via the API dashboard.
Manage API notification settings in the API UI
Set up notifications about API usage and performance for multiple email addresses in the API dashboard (API > Email Notifications). Choose the types of notifications each recipient will receive from the list of events.
New webhook events for FreeForm Document Groups
Set up ‘Create’/‘Resend’/‘Signed’/‘Cancel’ webhook events for FreeForm Document Group invites.
New “check_fields” attribute for ‘Upload’ and ‘Upload from URL’ requests
If the “check_fields” parameter is set as ‘true’, you can upload a document that contains simple text tags using basic upload requests.
Documentation:
New endpoints for managing CRM Contacts
Brand Template
If you’re looking for a faster way to create a custom brand theme without having to adjust every detail or resource individually, a pre-made Brand Template can save you the hassle of starting from scratch. A Brand Template contains up-to-date branding settings, allowing you to create a brand theme with a single API request.
New endpoints:
Decline Redirect URI and Redirect Target
“decline_redirect_uri”: Set a specific URL to which the signer will be redirected if they choose to decline a signing session.
“redirect_target”: Decide whether a redirect link should open in a new browser tab or in the current one. You can select from two possible values: 'blank' which opens the redirect link in a new tab, and 'self' which opens the link in the existing tab (the default value).
These parameters are applicable in the following endpoints:
Customize a Decline Invite message
Set a custom message to be displayed in a pop-up for signers who choose not to sign a document.
The parameter is applicable to the endpoints:
Copy a Document Group Template
Create an exact replica of a Document Group Template, which includes copies of every individual template contained within it.
Create a Document Group from a Document Group Template
Generate a Document Group directly from a Document Group Template.
Set signer language
Set the language of a signing session and notification emails (“en” – English, “es” – Spanish, “fr” – French).
New attributes are available for the POST Invite to sign (Field Invite), POST Create DG invite, POST Create Embedded invite, and POST Create Embedded invite for DG endpoints.
New endpoints to manage CRM users
Duplicate a template
Create a new template by making a copy of an existing template and editing it.
Create a copy of a Document Group
Copy a Document Group (regardless of its current status) and rename it.
New documentation chapter: Webhooks
Find all the information you need about webhooks in one place.
Contact Groups
Create, get, or edit Contact Groups. Or get, add, or delete contacts from a Contact Group.
Send a Document Group invite to a group of recipients
Send a Document Group for signature to an entire Contact Group.
Add metadata to Documents and Document Groups
Add metadata to selected Documents or Document Groups. All added metadata is then linked to the corresponding Documents and Document Groups when sending an eSignature invite.
Documentation links:
Get a Document or Document Group’s metadata
Retrieve metadata for a selected Document or Document Group.
Documentation links:
Remove metadata from a Document Group
Delete metadata for a specific Document Group.
Webhooks: New attribute "include_metadata" for the Create Event Subscription webhook
Add metadata to Documents or Document Groups (as described in the documentation for the corresponding endpoints).
Applicable values:
Customize a welcome message
Сustomize the text in a welcome pop-up that appears once a signer starts their signing session.
Find more details here.
New documentation chapter: Custom branding via API
Find all the information you need about signNow’s Custom Branding feature in one place.
Custom Branding: Email customization
Added new email customization options. Find more information in the links below:
API Dashboard: Development Mode
Create an application in Development Mode to test the signNow API for free. Then, seamlessly switch to Live Mode when ready.
Find more details here.
Create a Document Group from a template
Generate a Document Group from a Document Group Template.
Find more details here.
Webhooks: Get a list of event subscriptions
Return the list of events that an application is subscribed to.
Find more details here.
Webhooks: Get subscription info
Retrieve detailed information about an event subscription by its ID.
Find more details here.
Webhooks: Get a list of callbacks by event subscription
Retrieve a list of webhook events (event histories) by a subscription ID.
Find more details here.
Webhooks: Get callback info by a webhook ID
Retrieve detailed information about a webhook by its ID.
Find more details here.
Organization: Get a user’s documents
Browse the documents of users within a specific organization. This feature is only available to an organization’s Administrator.
Find more details here.
Move documents in bulk
Move multiple documents simultaneously to a specific folder.
Find more details here.
Empty the trash bin folder
Remove all documents from the trash bin directory. Documents are permanently deleted and cannot be restored.
Find more details here.
Embedded Signing: New attributes for pre-filling signature fields and disabling signature editing for signers
Prevent signers from editing pre-filled values in signature fields.
Documentation links:
API rate limits
When you reach the allowed limit of API requests, you receive a 429 error with the message “You exceeded the rate limit of {limit} API requests per hour.”
Find more details here.
PKI: Advanced Electronic Signature
Protect the integrity and authenticity of your signed documents with the Public Key Infrastructure (PKI).
Find more details here.
Update the status of a team invite
Update the status of an invitation to join a team (only applies to pending requests).
Find more details here.
New Document Group Templates directory in the API documentation
Find all endpoints related to Document Group Templates in the new documentation folder.
Webhooks: a new response attribute for all events
The new “initiator_id” webhook response allows you to identify users related to specific events triggered. The contained value is the signer ID.
Find more details here.
Get authentication data from a Document or Document Group history
Retrieve authentication data from a Document or Document Group history as a JSON attribute. The data is available only when the authentication is done via an SMS or phone call.
Documentation links:
Add a Carbon Copy recipient for a Document Group
Add a CC’d email address when sending a Document Group.
Find more details here.
Get template copies
Retrieve a full list of documents created and sent using a specific template.
Find more details here.
Sort templates by date
Sort templates by most recently sent invites. Sorting preferences apply to the Template folder and custom folders.
Documentation links:
Alignment parameters for Text tags and Complex tags
Apply one of the new optional parameters to align text horizontally inside a text field. The alignment parameters are compatible with text and hyperlink fields.
Find more details here.
Get information about a Document Group
Obtain essential information about specific Document Groups. The data contained in a Document Group is accessible to its owner and other users who take part in the signing process (at any step of the process).
Find more details here.
Download a Document Group
Download all documents contained in a specific Document Group.
Find more details here.
Download a document with its ID displayed on every page
Use the new email attribute to get a zip file that contains a document with its ID rendered on every page, as well as its attachments and history file (if requested).
Find more details here.
Rename a completed document based on field data for Embedded Signing Invites
Generate a document name based on the filled-in data of selected fields once the document is completed.
Find more details here.
Field Invites: New attributes to pre-fill signature fields and disable signature editing for signers
Choose between two options when managing Field Invites:
- Pre-fill a signature field and allow the signer to edit the signature
- Pre-fill a signature field and disable signature editing
Find more details here.
Two-factor authentication for Embedded Invites
Apply the following authentication methods to Embedded Invites (Documents): SMS, Phone Call, Password. Learn more here.
Apply various branding styles to individual eSignature invites
Create multiple custom branding configurations (including custom logo, color scheme, email message, etc.) and apply any of them to an eSignature invite.
Get field data from a completed document
Use the new GET endpoint to extract filled-in data from a document’s fields. Learn more here.
Transfer users across Organizations
Transfer users between signNow Organizations using API requests. Note: You must be an Admin of both Organizations to transfer users between them.
Favorite Documents and Document Groups
Mark Documents and Document Groups as Favorites. Get a list of Favorites from every folder stored in an account.
Find more information here.
New filter: Unsent
The new "Unsent" option is available for document filtering by signing status. The filter is available for the following requests: Get user's folder, Get folder by ID.
Embedded editor for Document Groups
Create a link that allows users to edit a Document Group without sending it for signature.
Find more information here.
Custom branding: White label your recipient’s signing experience
White labeling allows application owners to customize the signing experience for users based on their branding.
White labeling enables you to:- -Apply your brand colors and logo
- -Customize text for UI elements
- -Enable/disable specific UI elements
- -Set custom email responses
The custom branding options are available for signing sessions and signature invite emails.
Read what elements can be customized here.
Find more information here.
Documentation and endpoints for custom branding are available here.
Invite users to sign via a QR code
Generate a link to a QR code image. A QR code opens a document for signature.
View documentation here.
Customize a two-factor authentication SMS message for Documents and Document Groups
Set a custom message when sending an SMS to authenticate a signer. Messages can only be customized for the SMS authentication type.
More information on Documents and Document Groups is available via the links.
Receive an email notification before automatically unsubscribing from webhooks
When the conditions are met, a user’s event subscriptions (webhooks) can be deactivated or automatically unsubscribed. With this new functionality, we will notify users via email before this action takes place to avoid unexpected scenarios with application performance.
We will send a warning email to the subscription owner's inbox if the callback reaches 10 errors within 10 minutes with a “Host unreachable” response. If no action is taken, we will deactivate the webhook subscription and send an email confirmation.
Deactivation trigger: if a callback reaches 30 errors within 60 minutes with a “Host unreachable” response.
You can change the notification’s email address by making a request to the support team.
Find more information here.
Remove access_token from callback payload (new parameter)
With this new parameter, you can remove the access_token from the Webhook callback payload. Find more information here.
Manage Smart fields inside a template
More actions for Smart fields are now available via the API. Use the new endpoints to:
Customize a message for an SMS invite
Send your signature invites via SMS and leave a dedicated message to your recipients (the same as when sending a signature invite via an email). To add a custom message, include “sms_message” in the body of the request. Find more information and a cURL example here.
Send merged Document Groups for signature
Сreate a signature invite for a merged document group. Your document group will open as one document for the signer. Using API calls, you can create a signature invite for a merged Document Group or an embedded signature invite for a merged Document Group.
Check the email status of a signature invite
Сheck the email status of signature invites using the API. Display "Sent," Opened", "Clicked", or "Bounced" email statuses. Find more information here.
Add Smart field values to redirect URLs
Add the values of Smart fields into redirect URIs using placeholders when creating a link for templates that contain Smart fields.
Example: https://google.com?firstname=[smart_fields.firstname]&lastname=[smart_fields.lastname]
Find more information here.
Import templates from DocuSign to your signNow account
Upload a zip file containing a JSON from DocuSign to the user’s signNow account and receive a unique template ID.
Add hyperlink fields using complex text tags
Add and configure hyperlink fields to a document using hyperlink tags. Set up a field’s position, make it required or optional, and assign it to a recipient.
Add an extra layer of safety by applying an HMAC security key
Ensure your callback payload wasn’t changed during delivery to your app using the HMAC Security algorithm.
Send signature invites via SMS
The new Invite via SMS feature allows you to send an SMS containing an invite link to your document or template right from your website or app. This functionality is available for US and Canadian phone numbers.
Meet new PHP SDK enhancements
We’ve added new features to the PHP SDK:
Embedded signing
- Create an embedded invite for a document
- Create a signing link for an embedded invite
- Change an expiration date of a signing link
- Delete an embedded invite for a document
- Reassign signers in an embedded invite
Pre-fill fillable text fields in a document
Read more here
Set up a signature type for signature fields
A document sender can now predefine the signature type that a signer can add to a signature field using PUT/document. To set the signature type, you should include “type”, “draw”, or “upload” in the “allowed_types" parameter of the signature field. The same signature field can have one, two, or three allowed types. Learn more here.
cURL example:
curl --location --request PUT '{{url}}/document/{{document_id}}' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{access_token}}' \
--data-raw '{
"fields": [
{
"page_number": 0,
"type": "signature",
"role": "Signer 1",
"x": 349,
"y": 58,
"width": 177,
"height": 50,
"required": true,
"name": "signature1",
"allowed_types": [
"draw"
]
}
]
}'
Use the Run in Postman button on the API Dashboard page
Import signNow API collection into your Postman client or open it in your browser using the new button.
Updated actions for document senders
- A document sender can not delete documents with a Waiting for Others status (DELETE /document/ID).
- A document sender can not make API calls to GET /document/ID for documents in Trash folders.
- A document sender can not download documents in Trash folders (GET /document/{documentId}/download).
Test your apps in the updated demo environment
The evaluation servers have been updated to accommodate the production environment. Developers can now test their apps in the signNow demo environment using all the production environment's features.
Send a document to multiple recipients via API
The new API endpoint v2/documents/DOC_UNIQUE_ID/embedded-invites is available only for users with an API subscription. API users can send a document to multiple signers by creating embedded signing links for each signer.
Track embedded invite calls in your API dashboard
Track embedded invite call activity using the following endpoints:
- v2/paid-request-monthly-totals
- v2/paid-request-logs
Instantly switch from Sandbox to production
Easily hop in the production environment from the signNow evaluation servers.
Get started sooner with the signNow API
Access the step-by-step onboarding guides in the API Dashboard. Get your questions instantly resolved via the list of guides provided directly in your evaluation account:
- API Reference
- SDKs
- Video Guides
- Out-of-the-box signNow Apps
- More code examples
Track the status of events via the new Webhooks tab
Checking your API events is easier! The new Webhooks tab displays a grid with the current user’s successful events subscriptions (ES) created using Webhooks 2.0. It contains the following columns:
- App
- Event
- Entity ID
- Callback URL
- Date (date and time when the ES was created in timestamp format)
Explore the signNow API in the updated demo environment
Get unlimited access to the signNow testing environment to try out the signNow API. Your account won’t have an expiration date, document management limits or functionality limitations.
Meet .NET/C# SDK release for the signNow API
Enjoy the following improvements:
- all field types added
- retrieve field content
- role-based invite
- free form invite
- retrieve invite status
Manage your subscription from My Account
Check your subscription name, status and upgrade your plan directly from the Profile >> Subscription tab in My Account.
Easily manage your API plan
Check your signature invite spendings using the Plan Usage tab in the API Dashboard. Here you can also view signature invite details as well as generate and download your plan’s status reports.
Introducing the API dashboard
The API dashboard is a full-featured environment for receiving legally binding e-signatures via the signNow API. The dashboard allows you to create and manage apps using API keys for your integrations and reviewing API logs for troubleshooting.
Use API logs to fix your issues with the signNow API
API logs with detailed error messages will help you quickly debug and troubleshoot the signNow API. Send the ID of API logs to our solution engineers to get quick assistance.
Try all signNow API features in your free sandbox account
Test the signNow API before integrating it with your website or app. Create your Sandbox account, get API keys, and run generated code examples in less than 10 minutes.
Please note that Coming Soon feature release dates may vary. Release dates for these features are all subject to change and serve as a preview for what we’re currently working to add or improve.
Send eSignature invites from a Gmail account
Coming soonAuthorize the system to send eSignature invites from the user’s Gmail account.
Please note that Coming Soon feature release dates may vary. Release dates for these features are all subject to change and serve as a preview for what we’re currently working to add or improve.
-
Best ROI. Our customers achieve an average 7x ROI within the first six months.
-
Scales with your use cases. From SMBs to mid-market, airSlate SignNow delivers results for businesses of all sizes.
-
Intuitive UI and API. Sign and send documents from your apps in minutes.