post https://api.pandadoc.com/public/v2/notary/notarization-requests
Use this endpoint to connect with a notary, ready to complete online notarizations for your signers within minutes.
Before you start
Ensure the following before creating a notarization request:
- Install the Notary On-Demand add-on.
- Activate a user, typically the org admin, with an API key in the Notary app. For activation, direct them to visit https://notarize.pandadoc.com.
- Create a document for notarization and get its
document_id
. To create a document, use the Create Document from Template or Create Document from File Upload endpoint.
For the notarization request, include in the request body:
document_id
- At least one
invitees
, specifying theiremail
,first_name
, andlast_name
. - Optionally, include a
message
for your signers.
After the API call is executed, your signers will receive an email invitation for notarization. Alternatively, you can directly share the notarization_link
with your signers, which is available in the 201 response body.
Upon successful notarization, you will receive an email with a link to the notarized document.
Tips
- Ensure that signers are added as both invitees in the request body and recipients in the document to avoid inconveniences during notary sessions.
- Signers will receive an email with a notary link upon a successful API call; this link is also in the 201 response.
- Use the link to connect with commissioned online notaries, available Mon-Fri, 8 AM - 8 PM Central Time, typically responding within 2 minutes.
- Please note that a notary will notarize a copy of the original document, so it will not be available in your workspace.
Limits
A maximum of 100 API calls per minute is permitted. Exceeding this limit triggers a 429 Too Many Requests error.
Solutions for 4xx Response Codes
- 403 Forbidden (Inactive Add-on): Ensure the Notary On-Demand add-on is installed.
- 403 Forbidden (Transactions Limit): Purchase additional transactions either through the Notary UI or by contacting the Sales team.
- 403 Forbidden (User Not Activated): Activate a user, typically the org admin, with an API key in the Notary app. For activation, direct them to visit https://notarize.pandadoc.com.
- 429 Too Many Requests: If you hit the limit, hold your API calls, then send them after waiting for the retry time.
To learn more about PandaDoc Notary On-Demand, visit our website.