---
title: "Embed ZUGFeRD invoice into an existing PDF"
method: POST
path: "/api/zugferd/embed"
tags: ["ZUGFeRD / Factur-X"]
---

# Embed ZUGFeRD invoice into an existing PDF

`POST /api/zugferd/embed`

## Request

- Base URL: `https://api.dokmatiq.com`
- URL: `https://api.dokmatiq.com/api/zugferd/embed`
- Auth: API key in header `X-API-Key`

Takes an existing PDF and invoice data, converts the PDF to PDF/A-3 and embeds a ZUGFeRD/Factur-X XML invoice. The invoice data is passed as a JSON part. Supported profiles: MINIMUM, BASICWL, BASIC, EN16931 (default), EXTENDED, XRECHNUNG.

## Response `200`

ZUGFeRD PDF

## Other responses

- `400`: Invalid input
- `500`: Embedding failed

---

[API](https://skmtc.dev/dokmatiq/apis/docgen-api.md) · [All operations](https://skmtc.dev/dokmatiq/apis/docgen-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dokmatiq/apis/docgen-api/revisions/3fa1a922764d?raw)