Fejlesztőknek · For developers

FormEmpire API v1

A FormEmpire űrlapjai és beküldései REST API-n is elérhetők: a saját rendszered (CRM, készletkezelő, webshop) lekérdezheti a beküldéseket, állíthatja az állapotukat, és webhookkal azonnal értesülhet az új beküldésekről. Ugyanerre épülnek a Make-, Zapier- és n8n-modulok.

English summary: FormEmpire is a Hungarian form builder for quotes and orders. The API is a JSON REST API over HTTPS at https://formempire.hu/api/v1, authenticated with a Bearer API key. Each endpoint below has an English description.

Hitelesítés · Authentication

API-kulcsot az alkalmazásban, az API menüpontban készíthetsz (Pro csomagtól; csak admin). A kulcs a teljes fiókhoz fér hozzá, és bármikor visszavonható. Minden kérésben küldd el az Authorization fejlécben:

curl https://formempire.hu/api/v1/me \
  -H "Authorization: Bearer fe_live_…"

{ "account": { "id": "cm…", "name": "Minta Kft.", "plan": "Pro" } }

Hibás vagy visszavont kulcs: 401. Ha a fiók csomagja nem tartalmazza az API-t: 403. Korlát: 120 kérés / perc / kulcs, felette 429. Hiba esetén a válasz: { "error": { "code": "…", "message": "…" } } (invalid or revoked key → 401; plan without API → 403; rate limit → 429).

Végpontok · Endpoints

GET	/api/v1/me	A kulcshoz tartozó fiók (név, csomag). Account of the key — use it to test the connection.
GET	/api/v1/forms	Az űrlapjaid lapozva: id, name, type, status, submissions, createdAt, updatedAt. Paraméterek: limit (1–100, alap 50), cursor. Your forms, paginated (limit, cursor).
GET	/api/v1/forms/{id}	Egy űrlap a mezőivel (key, label, type). A mezők kulcsa ugyanaz, mint a beküldések answers részében. One form with its fields.
GET	/api/v1/forms/{id}/submissions	Beküldések lapozva. Paraméterek: limit (1–100), order (desc\|asc), since (ISO 8601), partial=true (félbehagyottak is), cursor. Submissions, paginated: limit, order, since, partial, cursor.
GET	/api/v1/submissions/{id}	Egy beküldés; a csatolmányok 30 napig érvényes, aláírt letöltőlinkkel. One submission with signed file links (30 days).
PATCH	/api/v1/submissions/{id}	status, tags, note módosítása. Pl. { "status": "DONE", "tags": ["fizetve"] }. Update status, tags, note.
GET	/api/v1/forms/{id}/webhooks	Az űrlap webhook-feliratkozásai. Webhook subscriptions of a form.
POST	/api/v1/forms/{id}/webhooks	Feliratkozás: { "url", "name"?, "partial"? } → minden új beküldés a megadott címre megy; a válaszban az aláíró kulcs (secret). Subscribe (REST hook). Returns id and signing secret.
DELETE	/api/v1/webhooks/{id}	Leiratkozás. Unsubscribe.

Lapozás: a listák nextCursor mezője, ha nem üres, a következő oldal kulcsa (?cursor=…). Időpontok: ISO 8601, UTC (2026-10-08T16:57:47.472Z). Állapotok: NEW · IN_PROGRESS · DONE (űrlapok) · NEW · IN_PROGRESS · SENT · ACCEPTED · REJECTED (ajánlatkérések).

curl "https://formempire.hu/api/v1/forms/{id}/submissions?since=2026-10-01T00:00:00Z&order=asc&limit=50" \
  -H "Authorization: Bearer fe_live_…"

A beküldés alakja · Submission payload

A listák elemei és a webhook törzse ugyanazt az alakot használják: submission (azonosító, időpont, állapot, címkék, link), answers (a válaszok mezőkulcs szerint, nyers értékkel) és fields (a mezők sorrendben, szöveges értékkel – ez a legkényelmesebb táblázatba vagy e-mailbe). Fájlmezőnél az érték { name, size, type, url }, ahol az url 30 napig érvényes, aláírt letöltőlink. A webhookban ezen felül event, deliveryId, sentAt, test és form is szerepel.

{
  "event": "submission.created",
  "deliveryId": "cmy…",
  "sentAt": "2026-10-08T16:57:47.472Z",
  "test": false,
  "form": { "id": "cmx…", "name": "Rendelés", "url": "https://formempire.hu/f/cmx…" },
  "submission": {
    "id": "cmy…", "createdAt": "2026-10-08T16:57:47.472Z", "partial": false,
    "status": "NEW", "tags": [], "url": "https://formempire.hu/app/bekuldesek/cmy…",
    "page": "https://pelda.hu/rendeles"
  },
  "answers": { "nev": "Minta Anna", "email": "anna@pelda.hu", "darabszam": 2 },
  "fields": [
    { "key": "nev", "label": "Név", "type": "text", "text": "Minta Anna" },
    { "key": "email", "label": "E-mail-cím", "type": "email", "text": "anna@pelda.hu" }
  ]
}

Webhook · Instant events

Feliratkozás a POST /api/v1/forms/{id}/webhooks végponttal (vagy az űrlap Összekötések fülén). Esemény: submission.created minden beküldésnél; submission.partial a félbehagyott kitöltéseknél, ha a feliratkozás partial: true. A kérés POST, JSON törzs, 10 másodperces időkorlát; 2xx = kézbesítve. Hiba esetén 1, 5, 30, 120 és 480 perc múlva újrapróbáljuk; 410 válaszra a feliratkozást kikapcsoljuk.

Aláírás: X-FormEmpire-Signature: sha256=HMAC_SHA256(secret, timestamp + "." + body) és X-FormEmpire-Timestamp fejléc; a secret a feliratkozás válaszában (vagy az Összekötések fülön) látható. Belső hálózati címre (localhost, 10.x, 192.168.x…) nem küldünk.

Kész modulok · Ready-made integrations

Make: FormEmpire app (Watch Submissions instant trigger, List Submissions, Get/Update a Submission, List Forms).
Zapier: FormEmpire integration (New Submission instant trigger, Update Submission).
n8n: n8n-nodes-formempire community node (FormEmpire Trigger, FormEmpire).

Kérdés, hiányzó végpont: hello@formempire.hu.