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

# Create an Electronic Seal

`POST /electronic_seals`

Create a new Electronic Seal

## Request body

- CreateElectronicSealPayload
  - `document_id` string, uuid, required — Specify which Electronic Seal Document to use for creating an Electronic Seal.
  - `image_id` string, uuid, nullable — Specify which Electronic Seal Image to use for creating an Electronic Seal.
  - `external_id` string, nullable — Store a custom id that will be added to webhooks
  - `fields` CreateElectronicSealPayloadFieldsInner[], required — Fields you want to add to your Document. At least one Seal Field is mandatory.
    - union
      - object
        - `type` 'seal' | 'read_only_text', required
        - `height` integer, required
        - `width` integer, required
        - `page` integer, required
        - `x` integer, required
        - `y` integer, required
        - `reason` string
        - `captions` CreateElectronicSealFieldSealPayloadCaptionsInner[], nullable — Optional captions to display on the seal image. Limited to one caption per field.
          - `text` string, required — The caption text to display on the seal image.
      - object
        - `type` 'read_only_text', required
        - `height` integer, required
        - `width` integer, required
        - `page` integer, required
        - `x` integer, required
        - `y` integer, required
        - `text` string, safe-string — This property is a [Safe String](https://developers.youtrust.com/reference/oas-specification#safe-string).
  - `signature_level` 'electronic_signature' | 'advanced_electronic_signature', nullable — Level of Electronic Seal for your Document
  - `certificate_id` string, uuid, nullable — Specify which certificate to use for creating an Electronic Seal (only available for advanced_electronic_signature level).

## Response `201`

Created

- ElectronicSeal — Electronic Seal that triggered the webhook event.
  - `id` string, uuid, required — Unique identifier of the Electronic Seal.
  - `status` 'pending' | 'done' | 'error', required — Status of the Electronic Seal.
  - `signature_level` 'electronic_signature' | 'advanced_electronic_signature' | 'qualified_electronic_signature', required — Electronic seal level used for of the Electronic Seal.
  - `created_at` string, date-time, required — Electronic Seal creation date and time.
  - `external_id` string, required — Custom identifier added to webhook.
  - `timestamp` boolean, required — Boolean indicating whether this Electronic Seal contains a qualified timestamp. For Advanced and Qualified Electronic Seal level, the value will be set to `true`. For Simple Electronic Seal level, the value will be set to `false`.
  - `document_id` string, uuid, required — Unique identifier of the Document.
  - `image_id` string, uuid, required — Unique identifier of the Image added to the Electronic Seal.

## Other responses

- `400` — Bad request
- `401` — Access unauthorized
- `403` — Access forbidden
- `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/versions/8d258c0b45d6/schema)