Sign in

v1

latestOpenAPI 3.1.02026-07-14220425.8 KB
Submissions

Create a submission from HTML

This API endpoint allows you to create a one-off submission request document using the provided HTML content, with special field tags rendered as a fillable and signable form.<br><b>Related Guides</b><br><a href="/keyring-guides/create-pdf-document-fillable-form-with-html-api.html" class="link">Create PDF document fillable form with HTML</a>

post/submissions/html

Request body

namestring

Name of the document submission.

send_emailboolean

Set false to disable signature request emails sending.

send_smsboolean

Set true to send signature request via phone number and SMS.

order'preserved' | 'random'

Pass 'random' to send signature request emails to all parties right away. The order is 'preserved' by default so the second party will receive a signature request email only after the document is signed by the first party.

completed_redirect_urlstring

Specify URL to redirect to after the submission completion.

bcc_completedstring

Specify BCC address to send signed documents to after the completion.

reply_tostring

Specify Reply-To address to use in the notification emails.

expire_atstring

Specify the expiration date and time after which the submission becomes unavailable for signature.

template_idsinteger[]

An optional array of template IDs to use in the submission along with the provided documents. This can be used to create multi-document submissions when some of the required documents exist within templates.

merge_documentsboolean

Set true to merge the documents into a single PDF file.

Example request

{
  "name": "Test Submission Document",
  "expire_at": "2024-09-01 12:00:00 UTC",
  "documents": [
    {
      "name": "Test Document",
      "html": "<p>Lorem Ipsum is simply dummy text of the\n<text-field\n  name=\"Industry\"\n  role=\"First Party\"\n  required=\"false\"\n  style=\"width: 80px; height: 16px; display: inline-block; margin-bottom: -4px\">\n</text-field>\nand typesetting industry</p>\n",
      "size": "A4"
    }
  ],
  "submitters": [
    {
      "role": "First Party",
      "email": "john.doe@example.com",
      "phone": "+1234567890",
      "fields": [
        {
          "name": "First Name",
          "validation": {
            "pattern": "[A-Z]{4}"
          },
          "preferences": {
            "font_size": 12,
            "format": "DD/MM/YYYY",
            "price": 99.99
          }
        }
      ]
    }
  ]
}

Response

OK

idinteger required

Submission unique ID number.

namestring

Submission name.

source'invite' | 'bulk' | 'api' | 'embed' | 'link' required

The source of the submission.

submitters_order'random' | 'preserved' required

The order of submitters.

status'completed' | 'declined' | 'expired' | 'pending' required

The status of the submission.

expire_atstring required

Specify the expiration date and time after which the submission becomes unavailable for signature.

created_atstring required

The date and time when the submission was created.

Example response

{
  "expire_at": "2024-09-01 12:00:00 UTC"
}