eSign Transaction Quickstart Guide

The Notarize Business API lets you send documents for Notarization or eSignature with just a few lines of code. Our RESTful APIs are designed to have predictable, resource-oriented URLs.

To get started with a Notarize account, see our pricing page, or contact [email protected] if you have any questions about your account.

1. Generate your API key.

See our guides on API Keys for more info.

2. Create Transaction

The minimum required parameters to create a Business eSign transaction via the Create Transaction endpoint are

1. the signer's email address
2. a document with the following attributes:

• document_requirement = esign (OR esign_authenticated)
• customer_can_annotate = true

See our guide on document requirements for more info.

POST /transactions
{
  "signers": [
    {
      "email": "[email protected]"
    }
  ],
  "documents": [{
    "resource": "https://static.notarize.com/Example.pdf",
    "requirement": "esign",
    "customer_can_annotate": true
  }]
}

Alternatively, you can create the transaction as a draft, and then update it or add documents later:

POST /transactions

{
  "signers": [
    {
      "email": "[email protected]"
    }
  ],
  "draft": true
}

4. Add Documents to the Transaction

If you marked the transaction as a draft in step 3, call the Add Document endpoint to add the documents to be signed. The minimum required document parameters to create an eSign transaction are:

1. the signer's email address
2. a document with the following attributes:

• document_requirement = esign (OR esign_authenticated)
• customer_can_annotate = true

See our guide on document requirements for more info.

POST /transactions/ot_xxxxxxx/documents

{
    "resource": "https://static.notarize.com/Example.pdf",
    "requirement": "esign",
    "customer_can_annotate": true
}

5. Monitoring the Transaction

You can leverage Notarize webhooks to monitor the state of the transaction.

6. Retrieve the Completed Transaction

The Retrieve Transaction endpoint will return links to the completed documents. If you're interested in running a test end-to-end with a test notary session, see our testing guide.