Power Automate

Der Formfeed-Connector funktioniert in Power Automate, Power Apps, Logic Apps und Copilot Studio. Microsoft hat ihn zertifiziert, am 5. Oktober 2026 freigegeben und verteilt ihn Region für Region, zunächst als Preview wie jeden neu zertifizierten Connector. Er ist ein Premium-Connector: Flows und Apps, die ihn nutzen, brauchen eine Lizenz mit Premium-Connectors, wie für die HTTP-Aktion. Bis er in Ihrer Umgebung erscheint, erledigt die HTTP-Aktion dieselbe Aufgabe mit einer Anfrage, siehe das Ende dieser Seite.

Der Connector ist englischsprachig; Aktionen und Felder heißen in Power Automate so, wie sie hier stehen.

Verbinden

Legen Sie eine Formfeed-Verbindung an und fügen Sie einen API-Schlüssel aus der App (API-Schlüssel) unverändert ein: Das Präfix Bearer ergänzt der Connector. Ein ff_test_-Schlüssel rendert kostenlos (im Free-Plan mit Wasserzeichen), genau richtig beim Bauen eines Flows. Die Vorgabe-Scopes eines neuen Schlüssels (render:create, render:read, template:read, account:read) decken den Verbindungstest, die Vorlagenauswahl mit ihren Feldern und jede Aktion ab. When a render or batch finishes registriert einen Webhook-Endpunkt; der Schlüssel braucht dafür zusätzlich den Scope webhook:manage, den neue Schlüssel nur haben, wenn Sie ihn ankreuzen.

Aktionen und Trigger

Operation	Was sie tut
Create a document	Rendert eine Vorlage als PDF, PNG, JPG oder WebP und eine Word- oder PowerPoint-Vorlage als DOCX, PPTX oder PDF. Liefert das Rendering mit Download-Link, Seitenzahl und Units.
Create a document file	Dasselbe Rendering, liefert aber die Datei selbst als File Content.
Create a document from HTML	Rendert HTML, das früher im Flow gebaut wurde, in Jinja2, Liquid oder Handlebars.
Create a document from a web page	Rendert eine öffentliche Seite.
Get a render	Liefert ein Rendering anhand seiner ID, mit frischem Download-Link.
Get a batch	Liefert den Fortschritt eines über die API angelegten Batch, seine Dokumente und die Zip-URL.
Convert a document to PDF	Wandelt eine Word-, Excel-, PowerPoint-, OpenDocument- oder RTF-Datei bis 20 MB in ein PDF um; die Datei wird nicht gespeichert. Ab dem Starter-Tarif.
When a render or batch finishes	Startet den Flow bei render.completed, render.failed, job.completed oder job.failed.

Die Felder der Operationen (die erweiterten führt der Designer bei den erweiterten Parametern):

Operation	Felder
Create a document, Create a document file	Template (Pflicht), Data (die Felder der Vorlage, siehe unten), Output (leer: das Format der Vorlage; PDF, PNG, JPG, WebP, DOCX oder PPTX), File Name; erweitert: Version, Locale (etwa de-DE)
Create a document from HTML	HTML (Pflicht), Template Language (Jinja2, die Vorgabe, Liquid oder Handlebars), Data, Output (leer PDF, sonst PNG, JPG oder WebP), File Name
Create a document from a web page	URL (Pflicht, eine öffentliche Seite), Output (leer PDF, sonst PNG, JPG oder WebP), File Name
Get a render, Get a batch	Render ID (rnd_…) bzw. Batch ID (job_…), Pflicht
Convert a document to PDF	File (Pflicht: DOCX, XLSX, PPTX, ODT, ODS, ODP, DOC, XLS, PPT oder RTF), File Name (leer der eigene Name der Datei mit .pdf); erweitert: Page Ranges (etwa 1-3,5), Landscape, One Page per Sheet
When a render or batch finishes	Events (Pflicht); erweitert: Environments (Renderings von Live-Schlüsseln, Test-Schlüsseln oder beiden; leer beide)

Felder aus Ihrer Vorlage

Die Vorlagenauswahl listet die Vorlagen des Workspace (bis zu 100); rendern lassen sich nur veröffentlichte, eine unveröffentlichte scheitert mit template_not_found. Mit der Auswahl der Vorlage lädt der Designer die Felder ihres Datenschemas oder, wenn sie keines hat, die Felder ihrer Beispieldaten. Verschachtelte Objekte werden zu Gruppen, Listen wie Rechnungspositionen zu Arrays: Ordnen Sie ihnen ein Array aus einer früheren Aktion zu, oder bauen Sie das ganze Data-Objekt mit einer Verfassen-Aktion. Version (erweitert) rendert einen Release Channel oder eine Versionsnummer statt der veröffentlichten Version.

Die Datei anhängen

Create a document file ist die richtige Aktion, wenn das Dokument als Datei weitergeht: Sein File Content ist der Anhang von E-Mail senden (V2) oder der Inhalt von Datei erstellen in OneDrive oder SharePoint. Geben Sie dem Anhang einen Namen mit Endung, etwa rechnung.pdf. Create a document liefert stattdessen den Download-Link, den eine Teams-Nachricht oder eine Spalte einer SharePoint-Liste braucht.

Lange Renderings

Ein Rendering, das länger als eine Minute dauert, läuft im Hintergrund weiter, und die Aktion wartet darauf: Power Automate fragt alle paar Sekunden erneut nach, bis das Dokument fertig ist, und liefert es dann wie gewohnt, bei Create a document file also die Datei. Schlägt das Rendering fehl, endet die Aktion mit seinem Fehler.

Der Trigger

When a render or batch finishes registriert einen Webhook-Endpunkt im Workspace, wenn der Flow eingeschaltet wird, und entfernt ihn beim Ausschalten; in der App erscheint er unter Webhooks als Power Automate. Die Ereignisse enthalten das Rendering, bei Batch-Ereignissen den Batch mit seiner Zip-URL. Power Automate prüft die Signatur der Zustellung nicht; die Callback-Adresse des Flows ist selbst geheim, und jedes Rendering eines Ereignisses lässt sich mit Get a render zurücklesen.

Bis der Connector in Ihrer Region ankommt

Microsoft hat den Connector am 5. Oktober 2026 freigegeben und verteilt ihn an jedem Arbeitstag an eine Gruppe von Regionen, beginnend an einem Freitag (frühestens am 9. Oktober): zuerst die eigene Testregion und die Preview-Region in den USA, dann Asien, dann Europa, dann Brasilien, Kanada, Japan und Indien und zuletzt Australien, das Vereinigte Königreich und die USA. Für die gesamte Verteilung nennt Microsoft 10 bis 14 Tage. Bis der Connector in Ihrer Umgebung erscheint, ruft die HTTP-Aktion (eine Premium-Aktion) die API direkt auf:

• Methode POST, URI https://api.formfeed.dev/v1/renders?output=binary
• Header Authorization: Bearer ff_test_…, Header Content-Type: application/json
• Body {"template": "invoice-de", "data": {"invoice": {"number": "2026-0042"}}}

Mit ?output=binary ist der Antwort-Body das Dokument selbst, body('HTTP') geht also direkt in einen Mail-Anhang; ohne den Parameter ist die Antwort das Rendering als JSON mit seiner download_url. Ein Rendering, das länger als eine Minute dauert, antwortet mit 202 und einer Location, die die HTTP-Aktion abfragt, bis das Dokument da ist, solange ihre Einstellung für das asynchrone Muster an ist (ihre Vorgabe). Den Aufbau der Anfrage beschreibt Rendering. Legen Sie den Schlüssel in eine sichere Eingabe oder eine Umgebungsvariable der Lösung statt in die Aktion.