---
title: "Create an Electronic Seal Document"
method: POST
path: "/electronic_seal_documents"
tags: ["Electronic Seal Document"]
---

# Create an Electronic Seal Document

`POST /electronic_seal_documents`

Create an Electronic Seal Document.

**ℹ️ This endpoint accepts two request body formats — pick the one that matches your use case:**
- 📁 `multipart/form-data` — upload a binary file.
- 📝 `application/json` — create from a JSON payload referencing a previously sealed source document.

**🔓 Endpoint access**
- Environments: `production`, `sandbox`
- API key scopes: `organization`, `workspace`
- Plans: `pro`, `scale`
- Add-ons (for production access): `Electronic Seal` or `Advanced Electronic Seal` or `Qualified Electronic Seal`

## Request body

- union
  - object — Create an Electronic Seal Document from a previously sealed document.
    - `electronic_seal_document_id` string, uuid, required — Id of the Electronic Seal Document. The Electronic Seal must be done to use its Electronic Seal Document.
  - object — Create an Electronic Seal Document from a Signature Request Document already signed.
    - `signature_request_document_id` string, uuid, required — Id of the Signature Request Document, the Signature Request must be Done.

## Response `201`

Created

- ElectronicSealDocument
  - `id` string, uuid, required
  - `total_pages` integer, required
  - `created_at` string, date-time, required
  - `workspace_id` string, uuid, required — Unique identifier of the Workspace in which this Electronic Seal Document is scoped.

## Other responses

- `400` — Bad request
- `401` — Access unauthorized
- `403` — Access forbidden
- `404` — Resource not found
- `405` — This method is not allowed
- `415` — UnsupportedMediaType
- `429` — Too Many Requests, please try again later.
- `500` — Internal Server Error

---

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