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.
- 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. - Optionally, using
disable_invitees_notifications
you can disable all notifications for invitees including email with invitation for notarization. This is useful when you are using alternative delivery methods.
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, 9 AM - 9 PM Central Time, typically responding within 2 minutes.
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.
- 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.