DocuSeal

The API endpoint allows you to archive a submission. This ARCHIVES rather than destroys: the submission disappears from the default listing (`archived=true` still lists it) and `PUT /submissions/{id}` with `archived: false` restores it. A 403 {"error":"Not authorized"} here means the id is not in this account (or the key's user role cannot see it) -- DocuSeal spells not-found that way for a valid key (measured 2026-09-19).

The API endpoint allows you to archive a document template. This ARCHIVES rather than destroys: the template disappears from the default listing (`GET /templates?archived=true` still lists it) and `PUT /templates/{id}` with `archived: false` restores it. A 403 {"error":"Not authorized"} here means the id is not in this account (or the key's user role cannot see it) -- DocuSeal spells not-found that way for a valid key (measured 2026-09-19).

The API endpoint provides the ability to retrieve a list of available submissions. Paginate with `after`/`before` from the response's `pagination` block; `status` is one of pending, completed, declined, expired.

The API endpoint provides the functionality to retrieve information about a submission. A 403 {"error":"Not authorized"} here means the id is not in this account (or the key's user role cannot see it) -- DocuSeal spells not-found that way for a valid key (measured 2026-09-19).

This endpoint returns a list of partially filled documents for a submission. If the submission has been completed, the final signed documents are returned. Returns document URLs, not bytes: before completion the partially filled PDFs, after completion the signed ones. A 403 {"error":"Not authorized"} here means the id is not in this account (or the key's user role cannot see it) -- DocuSeal spells not-found that way for a valid key (measured 2026-09-19).

The API endpoint provides the ability to retrieve a list of submitters. Paginate with `after`/`before` from the response's `pagination` block.

The API endpoint provides functionality to retrieve information about a submitter, along with the submitter documents and field values. A 403 {"error":"Not authorized"} here means the id is not in this account (or the key's user role cannot see it) -- DocuSeal spells not-found that way for a valid key (measured 2026-09-19).

The API endpoint provides the ability to retrieve a list of available document templates. Paginate with `after`/`before` (the response's `pagination.next` / `pagination.prev` ids); `limit` defaults to 10, max 100.

The API endpoint provides the functionality to retrieve information about a document template. A 403 {"error":"Not authorized"} here means the id is not in this account (or the key's user role cannot see it) -- DocuSeal spells not-found that way for a valid key (measured 2026-09-19).

This API endpoint allows you to create signature requests (submissions) for a document template and send them to the specified submitters (signers). Related Guides Send documents for signature via API (https://www.docuseal.com/guides/send-documents-for-signature-via-api) Pre-fill PDF document form fields with API (https://www.docuseal.com/guides/pre-fill-pdf-document-form-fields-with-api) Each submitter needs an `email` (DocuSeal answers 422 naming the submitter index otherwise) and a `role` matching one of the template's submitter roles; a template with one role accepts a single submitter without `role`. A template id that is not in this account answers 403. Creating a submission costs nothing; DocuSeal bills $0.20 per document once it is SIGNED (production accounts; Test Mode is free). `send_email` defaults to true and emails real people -- pass false while testing. `send_sms` sends a paid SMS ($0.20 each after 20/month) and needs a `phone` on the submitter.

The API endpoint provides functionality to create a one-off submission request from a DOCX file with dynamic content variables. Use `[[variable_name]]` text tags to define dynamic content variables in the document. See https://www.docuseal.com/examples/demo_template.docx (https://www.docuseal.com/examples/demo_template.docx) for the specific text variable syntax, including dynamic content tables and lists. You can also use the `{{signature}}` field syntax to define fillable fields, as in a PDF. Related Guides Use dynamic content variables in DOCX to create personalized documents (https://www.docuseal.com/guides/use-dynamic-content-variables-in-docx-to-create-personalized-documents) Each document's `file` is either the file's base64-encoded bytes or a publicly downloadable URL; a URL keeps the tool call small. Creating a submission costs nothing; DocuSeal bills $0.20 per document once it is SIGNED (production accounts; Test Mode is free). `send_email` defaults to true and emails real people -- pass false while testing. `send_sms` sends a paid SMS ($0.20 each after 20/month) and needs a `phone` on the submitter.

This API endpoint allows you to create submissions for a document template and send them to the specified email addresses. This is a simplified version of the POST /submissions API to be used with Zapier or other automation tools. One submission per address in the comma-separated `emails`, each sent as the template's first role. Creating a submission costs nothing; DocuSeal bills $0.20 per document once it is SIGNED (production accounts; Test Mode is free). `send_email` defaults to true and emails real people -- pass false while testing. `send_sms` sends a paid SMS ($0.20 each after 20/month) and needs a `phone` on the submitter.

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. Related Guides Create PDF document fillable form with HTML (https://www.docuseal.com/guides/create-pdf-document-fillable-form-with-html-api) Creating a submission costs nothing; DocuSeal bills $0.20 per document once it is SIGNED (production accounts; Test Mode is free). `send_email` defaults to true and emails real people -- pass false while testing. `send_sms` sends a paid SMS ($0.20 each after 20/month) and needs a `phone` on the submitter.

The API endpoint provides the functionality to create one-off submission request from a PDF. Use `{{Field Name;role=Signer1;type=date}}` text tags to define fillable fields in the document. See https://www.docuseal.com/examples/fieldtags.pdf (https://www.docuseal.com/examples/fieldtags.pdf) for more text tag formats. Or specify the exact pixel coordinates of the document fields using `fields` param. Related Guides Use embedded text field tags to create a fillable form (https://www.docuseal.com/guides/use-embedded-text-field-tags-in-the-pdf-to-create-a-fillable-form) Each document's `file` is either the file's base64-encoded bytes or a publicly downloadable URL; a URL keeps the tool call small. Creating a submission costs nothing; DocuSeal bills $0.20 per document once it is SIGNED (production accounts; Test Mode is free). `send_email` defaults to true and emails real people -- pass false while testing. `send_sms` sends a paid SMS ($0.20 each after 20/month) and needs a `phone` on the submitter.

The API endpoint allows you to clone an existing template into a new template. A 403 {"error":"Not authorized"} here means the id is not in this account (or the key's user role cannot see it) -- DocuSeal spells not-found that way for a valid key (measured 2026-09-19).

The API endpoint provides the functionality to create a fillable document template for an existing Microsoft Word document. Use `{{Field Name;role=Signer1;type=date}}` text tags to define fillable fields in the document. See https://www.docuseal.com/examples/fieldtags.docx (https://www.docuseal.com/examples/fieldtags.docx) for more text tag formats. Or specify the exact pixel coordinates of the document fields using `fields` param. Related Guides Use embedded text field tags to create a fillable form (https://www.docuseal.com/guides/use-embedded-text-field-tags-in-the-pdf-to-create-a-fillable-form) Each document's `file` is either the file's base64-encoded bytes or a publicly downloadable URL; a URL keeps the tool call small. Fields come from `{{Name;role=Signer;type=text}}` text tags inside the DOCX or from each document's `fields` array. Creating a template costs nothing.

The API endpoint provides the functionality to seamlessly generate a PDF document template by utilizing the provided HTML content while incorporating pre-defined fields. Related Guides Create PDF document fillable form with HTML (https://www.docuseal.com/guides/create-pdf-document-fillable-form-with-html-api) Fields are declared with tags such as `<text-field name="Full Name" role="Signer" required="true" style="width:160px;height:24px;display:inline-block"></text-field>` (also signature-field, date-field, initials-field, checkbox-field). Creating a template costs nothing.

The API endpoint allows you to merge multiple templates with documents and fields into a new combined template. Every id in `template_ids` must be in this account (a foreign or absent id answers 403). The merged template is a NEW template; the sources are untouched.

The API endpoint provides the functionality to create a fillable document template for a PDF file. Use `{{Field Name;role=Signer1;type=date}}` text tags to define fillable fields in the document. See https://www.docuseal.com/examples/fieldtags.pdf (https://www.docuseal.com/examples/fieldtags.pdf) for more text tag formats. Or specify the exact pixel coordinates of the document fields using `fields` param. Related Guides Use embedded text field tags to create a fillable form (https://www.docuseal.com/guides/use-embedded-text-field-tags-in-the-pdf-to-create-a-fillable-form) Each document's `file` is either the file's base64-encoded bytes or a publicly downloadable URL; a URL keeps the tool call small. Fields come from `{{Name;role=Signer;type=text}}` text tags inside the PDF or from each document's `fields` array. Creating a template costs nothing.

The API endpoint allows you to update a submission: change its name, expiration date, and archive or unarchive it. Also the way to UNARCHIVE a submission (`archived: false`). A 403 {"error":"Not authorized"} here means the id is not in this account (or the key's user role cannot see it) -- DocuSeal spells not-found that way for a valid key (measured 2026-09-19).

The API endpoint allows you to update submitter details, pre-fill or update field values and re-send emails. Related Guides Automatically sign documents via API (https://www.docuseal.com/guides/pre-fill-pdf-document-form-fields-with-api#automatically-sign-documents-via-api) ⚠ `completed: true` marks the submitter as signed WITHOUT the person acting -- it produces a signed document, which DocuSeal bills at $0.20 on a production account -- so send it only when auto-signing is what you mean. `send_email: true` / `send_sms: true` RE-SEND the request (SMS is paid). Pre-fill with `values` keyed by field name. A 403 {"error":"Not authorized"} here means the id is not in this account (or the key's user role cannot see it) -- DocuSeal spells not-found that way for a valid key (measured 2026-09-19).

The API endpoint provides the functionality to move a document template to a different folder and update the name of the template. Also the way to UNARCHIVE: pass `archived: false` to restore a template the archive tool removed. A 403 {"error":"Not authorized"} here means the id is not in this account (or the key's user role cannot see it) -- DocuSeal spells not-found that way for a valid key (measured 2026-09-19).

The API endpoint allows you to add, remove or replace documents in the template with provided PDF/DOCX file or HTML content. Each document's `file` is either the file's base64-encoded bytes or a publicly downloadable URL; a URL keeps the tool call small. Each document entry adds a file, or names an existing attachment to `replace` or `remove`. A 403 {"error":"Not authorized"} here means the id is not in this account (or the key's user role cannot see it) -- DocuSeal spells not-found that way for a valid key (measured 2026-09-19).