---
title: "Create an Electronic Signature check"
method: POST
path: "/v1/checks/electronic_signature"
tags: ["Electronic Signature check"]
---

# Create an Electronic Signature check

`POST /v1/checks/electronic_signature`

Create an Electronic Signature check. The check will be created with the specified document template.

## Request body

- ElectronicSignatureCheckCreate
  - `individual_id` string, uuid, required
  - `settings` ElectronicSignatureCheckSettingsCreate
    - `document_template_key` string, required
    - `automatic_approval` boolean

## Response `201`

Electronic Signature check has been created

**ℹ️ Click to see full payload**

- ElectronicSignatureCheck
  - `id` string, uuid, required
  - `individual_id` string, uuid, required
  - `is_internal` boolean, required
  - `status` 'in_progress' | 'need_review' | 'processing' | 'approved' | 'rejected' | 'expired', required — ℹ️ Check status `expired` is deprecated and will be removed Q1'25. It will be replaced with an expired flag.
  - `type` 'electronic_signature', required
  - `subtype` string, required — Contains `"document_template:{settings.document_template_key}"`
  - `last_activity_at` string, date-time, required — Latest activity date Date time in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) (`yyyy-MM-ddTHH:mm:ss.S+X` eg `2023-01-31T13:30:00.000Z`)
  - `data` ElectronicSignatureCheckData, required
    - `result` 'approved' | 'rejected' | 'error', nullable, required
    - `settings` ElectronicSignatureCheckDataSettings, required
      - `document_template_key` string, required
      - `automatic_approval` boolean, required
    - `vendor` ElectronicSignatureCheckDataVendor, required
      - `name` 'yousign', required
      - `status` string, nullable, required
      - `signature_request_ref` string, nullable, required
      - `signer_ref` string, nullable, required
      - `document_ref` string, nullable, required
      - `signature_link` string, nullable, required
      - `signature_link_expiration_date` string, date-time, nullable, required — Date time in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) (`yyyy-MM-ddTHH:mm:ss.S+X` eg `2023-01-31T13:30:00.000Z`)
      - `started_at` string, date-time, nullable, required — Date time in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) (`yyyy-MM-ddTHH:mm:ss.S+X` eg `2023-01-31T13:30:00.000Z`)
      - `ended_at` string, date-time, nullable, required — Date time in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) (`yyyy-MM-ddTHH:mm:ss.S+X` eg `2023-01-31T13:30:00.000Z`)
    - `information` ElectronicSignatureCheckDataInformation, required
      - `audit_trail_id` string, nullable, required
      - `file_id` string, nullable, required
      - `signed_file_id` string, nullable, required
    - `review` Review, required
      - `comment` string, nullable, required
      - `reviewed_at` string, date-time, nullable, required — Date time in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) (`yyyy-MM-ddTHH:mm:ss.S+X` eg `2023-01-31T13:30:00.000Z`)
      - `reviewer_type` 'user' | 'system' | 'api', nullable, required
      - `user` NestedUser, required
        - `id` string, uuid, required
        - `first_name` string, required
        - `last_name` string, required
        - `email` string, email, required

## Other responses

- `400` — The request is either malformed or contain invalid parameters. - Make sure the body payload matches the expected schema - Limit reached. Contact us at support@dotfile.com to lift all limits.

---

[API](https://skmtc.net/dotfile/apis/api-specifications.md) · [All operations](https://skmtc.net/dotfile/apis/api-specifications/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dotfile/api-specifications/versions/36393567057b/schema)