---
title: "Create Notarization Request"
method: POST
path: "/public/v2/notary/notarization-requests"
tags: ["Notary"]
---

# Create Notarization Request

`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](https://developers.pandadoc.com/reference/create-document-from-pandadoc-template) or [Create Document from File Upload](https://developers.pandadoc.com/reference/create-document-from-pdf) 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](https://notary.pandadoc.com/notary-on-demand/).

## Request body

- CreateNotarizationRequest
  - `document_id` string, required — ID of the Document for notarization.
  - `disable_invitees_notifications` boolean, nullable — Disable all notifications for invitees including email with invitation for notarization. This is useful when you are using alternative delivery methods.
  - `invitation` object, required
    - `message` string — Optional message for invitation email.
    - `invitees` object[]
      - `email` string, email, required
      - `first_name` string, nullable
      - `last_name` string, nullable
  - `notary` object — Optional notary assignment for in-house notary requests. Used for Bring you own notary use case. Only ACTIVE notaries can be used
    - `id` string, required — ID of an ACTIVE notary
    - `scheduled_at` string, date-time, required — ISO 8601 timestamp for scheduled notarization
    - `message` string — Optional custom message for the notary in the invitation email

## Response `201`

Notarization request has been created successfully

- CreateNotarizationResponse
  - `id` string — A unique identifier of the notarization request.
  - `name` string — A name of the notarization request.
  - `status` 'DRAFT' | 'SENT' | 'WAITING_FOR_NOTARY' | 'ACCEPTED' | 'LIVE' | 'COMPLETED' | 'INCOMPLETE' | 'CANCELLED' — Current status of the notarization request.
  - `date_created` string, date-time — A date when a notarization request was created.
  - `date_accepted` string, date-time, nullable — A date when a notarization session was accepted by notary.
  - `created_by` object
    - `user_id` string — A unique identifier of the user who created a notarization request.
    - `email` string — A user's email address.
    - `first_name` string — A user's first name.
    - `last_name` string — A user's last name.
  - `invitees` object[]
    - `id` string — A unique identifier of the invitee.
    - `email` string, email — A invitee's email address.
    - `first_name` string — A invitee's first name.
    - `last_name` string — A invitee's last name.
    - `notarization_link` string — A secure link to join a notarization request.

## Other responses

- `400` — Bad Request error
- `401` — Authentication error
- `403` — Permission error
- `429` — Too many requests error

---

[API](https://skmtc.net/pandadoc/apis/pandadoc-public-api.md) · [All operations](https://skmtc.net/pandadoc/apis/pandadoc-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pandadoc/pandadoc-public-api/revisions/0c2b70be3fb0/schema)