POST /public/v2/notary/notarization-requests

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.

Servers

https://api.pandadoc.com

Request headers

Name	Type	Required	Description
`Content-Type`	String	Yes	The media type of the request body. Default value: "application/json"

Request body fields

Name	Type	Required	Description
`invitation`	Object	Yes
`invitation.message`	String	No	Optional message for invitation email.
`invitation.invitees[]`	Array	No
`invitation.invitees[].email`	String	Yes
`invitation.invitees[].last_name`	String	No
`invitation.invitees[].first_name`	String	No
`document_id`	String	Yes	ID of the Document for notarization.
`disable_invitees_notifications`	Boolean	No	Disable all notifications for invitees including email with invitation for notarization. This is useful when you are using alternative delivery methods. Default value: false
`notary`	Object	No	Optional notary assignment for in-house notary requests. Used for Bring you own notary use case. Only ACTIVE notaries can be used
`notary.id`	String	Yes	ID of an ACTIVE notary
`notary.scheduled_at`	String	Yes	ISO 8601 timestamp for scheduled notarization
`notary.message`	String	No	Optional custom message for the notary in the invitation email

How to start integrating

Add HTTP Task to your workflow definition.
Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
Click Test request to test run your request to the API and see the API's response.