The Notarize Business API allows you to seamlessly send your signer and documents into Notarize to complete their necessary documents.
The API, organized around REST, is designed to have predictable, resource-oriented URLs, and uses HTTP response codes to indicate any API errors. Webhooks are available to enable you to be notified when a transaction changes state.
To get started, you must have a business account with Notarize. Sign up here.
Once you create a Notarize account, you will be able to generate your API key right from within your account.
To generate your key, go to:
Your business name in the upper right of your Notarize account >> Settings >> Scroll to API Key
These parameters allow you to customize your transaction for internal necessities as well as for the signer experience. You can set things like
message_to_signer, etc. A full list of parameters can be found in the Transactions - Create endpoint.
Once you have decided what your transaction parameters will be, it will be time to create the transaction. Make a POST request to the Transactions - Create endpoint.
pdf_bookmarked attribute to
If you are passing a
pdf_bookmarked document, it will take the Notarize system time to split the document. We will respond with a
200 and a response indicating that document upload is in progress. Should you wish to set your document parameters on a
pdf_bookmarked document, you must first wait for this upload to complete (~5min), recall the document object on the transaction, and use the document
id returned to update the documents flags.
You can find a full list of supported document parameters in the Documents - Add to transaction ] endpoint. These parameters allow you set document level permissions such as
witness_required. All document attributes are also supported in the [Update Document] endpoint.
You can leverage Notarize WebHooks to monitor the state of the transaction. There are several events fired - for example you will be able to see when your signer has
received and opened their transaction email as well as when they have
completed their signing.
If you have further questions about the Business API, you can find full technical specifications at the API Endpoint Reference.