Create Notarization Request

Create a notarization request to connect with a notary and complete online notarizations for your signers within minutes.

Important: This endpoint supports only documents in draft status.

Prerequisites

Before you start

Ensure the following before creating a notarization request:

• Install the Notary On-Demand or Notary 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.

Request Details

For the notarization request, include in the request body:

• document_id
• At least one invitees, specifying their email, first_name, and last_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.
• If in-house notary must be assigned to this request, include the notary object with the notary's id, scheduled_at timestamp, and an optional message for the notary

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.

Usage Tips

Best Practices

• 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
• In case if notary is not specified in the request, signers will use the link to connect with commissioned online notaries, available Mon-Fri, 9 AM - 9 PM Central Time, typically responding within 2 minutes
• If notary is specified, signers will use the link to connect with your in-house notary at the scheduled time

Limits

A maximum of 100 API calls per minute is permitted. Exceeding this limit triggers a 429 Too Many Requests error.

Troubleshooting

Solutions for 4xx Response Codes:

• 403 Forbidden (Inactive Add-on): Ensure the Notary On-Demand or Notary 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.