---
title: "Initiate Signature"
method: POST
path: "/api/signatures/initiate"
tags: ["Signatures"]
---

# Initiate Signature

`POST /api/signatures/initiate`

Start a CMD digital signature session.

Body: {
    document_type: "contract" | "proposal" | "declaration",
    document_id: 123,
    signer_type: "client" | "commercial",
    signer_phone: "+351912345678",
    signer_pin: "1234",
    signer_name: "João Silva" (optional),
    pdf_s3_key: "path/to/existing.pdf" (optional — if PDF already exists)
}

## Headers

- `x-api-token` string, nullable

## Request body

- object

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/multigest/apis/multigest-protected-api.md) · [All operations](https://skmtc.dev/multigest/apis/multigest-protected-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/multigest/multigest-protected-api/revisions/4b44eb76b3ee/schema)