---
title: "Sendet ein PDF zur mehrparteiigen elektronischen Signatur (DocuSign-Stil). Liefert die Vorgangs-id, einen ownerKey (geheim halten!) und pro Empfänger einen Signier-Link. fields platzieren Signatur-/Text-/Datum-/Checkbox-Felder per Ratio (0..1, y von oben). Emails an Empfänger nur über den zurückgegebenen ownerKey."
method: POST
path: "/tools/envelope_create"
---

# Sendet ein PDF zur mehrparteiigen elektronischen Signatur (DocuSign-Stil). Liefert die Vorgangs-id, einen ownerKey (geheim halten!) und pro Empfänger einen Signier-Link. fields platzieren Signatur-/Text-/Datum-/Checkbox-Felder per Ratio (0..1, y von oben). Emails an Empfänger nur über den zurückgegebenen ownerKey.

`POST /tools/envelope_create`

## Request

- Base URL: `https://api.tamgara.com/api/v1`
- URL: `https://api.tamgara.com/api/v1/tools/envelope_create`
- Auth: none declared

## Request body

- object
  - `ownerName` string, required: Name des Absenders/Erstellers.
  - `docName` string, required: Dokumentname, z. B. "Mietvertrag.pdf".
  - `pdfBase64` string, required: Das zu signierende PDF (z. B. aus fill_template).
  - `message` string: Begleitnachricht an die Empfänger (optional).
  - `expiresDays` integer: Ablauf in Tagen (0 = kein Ablauf).
  - `isPublic` boolean: Öffentlicher Signier-Link statt fester Empfänger.
  - `recipients` object[]: Empfänger (bei isPublic leer).
    - `name` string, required: Name des Unterzeichners.
    - `email` string: E-Mail (optional; für Einladung).
    - `order` integer: Reihenfolge (optional).
    - `lang` string: Sprache der Einladung: de | en.
  - `fields` object[]: Feld-Platzierungen.
    - `type` 'signature' | 'initials' | 'text' | 'date' | 'checkbox', required
    - `label` string: Feldbeschriftung.
    - `recipient` integer, required: Index des Empfängers (0-basiert).
    - `pageIndex` integer, required: Seitenindex (0-basiert).
    - `xRatio` number, required: X-Position 0..1 (Mitte).
    - `yRatio` number, required: Y-Position 0..1 von oben (Mitte).

## Response `200`

OK

## Other responses

- `400`: Fehler / ungültige Eingabe

---

[API](https://skmtc.dev/tamgara/apis/tamgara-api.md) · [All operations](https://skmtc.dev/tamgara/apis/tamgara-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tamgara/apis/tamgara-api/revisions/9435a5dea6d8?raw)