Hem > Integrationer > API och webhooks
Formify API och webhooks: elektronisk signering i dina egna system
Formify har ett REST-API med OAuth 2.0 och webhooks som signeras med HMAC. Din utvecklare kan skicka dokument för signering från ditt eget system, och du får ett meddelande när de öppnas, signeras eller förseglas.
Senast uppdaterad: 17 november 2026. Granskad av David Nordin
Viktiga fakta
| Signaturnivåer | Enkel elektronisk signatur med bläck (SES) och avancerad elektronisk signatur (AES) med pass och videoselfie enligt eIDAS |
|---|---|
| Inbjudningar | E-post, SMS eller WhatsApp |
| Språk i inbjudan | Engelska, svenska och spanska |
| Signerad PDF | Försedd med ett godkänt certifikat från en leverantör som finns med på EU:s lista över betrodda certifikatutfärdare |
| Var uppgifterna lagras | Dokument och data lagras inom EU, med Sverige som huvudsaklig region (där dina data lagras) |
| Kostnad | Kom igång gratis med 10 krediter per månad. Fyll på med minst 10 €, eller välj en plats från 25 € per månad. Det tillkommer ingen separat avgift för MCP-anslutningen. Priserna är exkl. moms. (krediter) |
| Autentisering | OAuth 2.0 eller API-nyckel |
| Format | OpenAPI, Markdown och llms.txt |
| krediter per sändning | Dokument som skickas via API:et använder krediter från din Formify-plånbok: 2 krediter för en enkel signatur med penna, 8 med pass och videoselfie. (krediter) |
Vad du kan göra
- Skicka KYC-formuläret från din egen kundportal när en ny fastighetsköpare registrerar sig.
- Få ett meddelande så fort alla parter har undertecknat (
document.completed) och spara den förseglade PDF-filen i ditt eget system. - Kräv pass och videoselfie (AES) i signeringsprocessen.
- Fyll i fälten i förväg och lås dem innan du skickar, så att kunden bara fyller i sin egen del.
- Läs in undertecknarens svar direkt i ditt eget system.
Webhook-händelser
| Evenemang | När det skickas |
|---|---|
document.created | Ett dokument har skapats och skickats för underskrift. |
document.opened | Dokumentet har öppnats. |
document.signed | En undertecknare har undertecknat. Datamängden innehåller även signeeId. |
document.completed | Alla parter har undertecknat och dokumentet är förseglat. |
document.revoked | Dokumentet har återkallats. |
document.deleted | Dokumentet har raderats. |
Varje händelse innehåller eventId, type, date (ISO 8601) och data med documentId, accountId och userId. Endast dokumenthändelser skickas.
Kom igång
- Skapa ett gratis Formify-konto.
- Be din utvecklare att läsa API-referensen.
- Skapa inloggningsuppgifter: OAuth 2.0 eller en API-nyckel i Formify-appen under Inställningar, Integration.
- Registrera en webhook till den adress som ditt system lyssnar på.
Vad fungerar, och hur?
| Vad du vill ha | Status | Så här fungerar det |
|---|---|---|
| Att veta när ett dokument är undertecknat eller förseglat | Behöver en utvecklare | Webhooks document.signed och document.completed |
| Kontrollera att webhooken verkligen kommer från Formify | Behöver en utvecklare | HMAC-SHA256 med slutpunktens whsec_ hemlighet |
| Få aviseringar utan hjälp av en utvecklare | Fungerar direkt ur förpackningen | I Make, med funktionen ”Visa färdiga dokument” |
| Skicka tillsammans med passet och en videoselfie | Behöver en utvecklare | Signaturtyp signatureFaceLiveness |
| Ladda ner den undertecknade PDF-filen | Behöver en utvecklare | En tidsbegränsad länk, giltig i 10 minuter |
| Webhooks för inställningar eller ändringar av kontot | Ej tillgängligt | Endast dokumenthändelser stöds |
| Testa utan produktionsdata | Behöver en utvecklare | sk_test_ nycklar i testmiljöer |
Vanliga frågor
Har Formify ett API?
Ja. Formify har ett REST-API som använder JSON och OAuth 2.0-klientautentiseringsuppgifter. Varje verktyg på Formify MCP-servern är kopplat till en REST-ändpunkt, och referensen publiceras som OpenAPI, Markdown och llms.txt på developers.formify.eu. För verktyg som inte kan använda OAuth kan du skapa en API-nyckel i Formify-appen under Inställningar, Integration.
Vilka webhook-händelser skickar Formify?
Sex, allt om dokument: document.created, document.opened, document.signed, document.completed, document.revoked och document.deleted. Varje webhook signeras med HMAC-SHA256 med hjälp av en hemlig nyckel som är unik för slutpunkten, så att ditt system kan kontrollera att den kommer från Formify. Du kan byta ut den hemliga nyckeln när det behövs.
Vad händer om vår server är nere när en webhook skickas?
Formify gör upp till fem försök: direkt, sedan efter cirka 5 minuter, 30 minuter, 2 timmar och 24 timmar. Din server bekräftar leveransen med ett 2xx-svar. En händelse kan anlända flera gånger eller i fel ordning, så din utvecklare bör använda eventId för att hoppa över dubbletter.
Kan vi lägga till identitetsverifiering via API:et?
Ja. Med signaturtypen signatureFaceLiveness skannar undertecknaren sitt pass och spelar in en videoselfie innan hen undertecknar. Detta ger en avancerad elektronisk signatur (AES) enligt eIDAS. För en enkel signatur med bläck använder du digital_ink.
Vi har ingen utvecklare. Vad kan vi göra?
Använd Make. Formify-appen på Make har färdiga moduler, till exempel ”Watch Completed Documents”, som startar ett scenario när ett dokument är klart, så att du kan vidta åtgärder utifrån undertecknade dokument utan att behöva skriva kod. Om du istället vill skicka och följa upp via chatten kan du koppla Formify till ChatGPT eller Claude.
På vilket sätt skiljer sig den här sidan från utvecklardokumentationen?
På den här sidan beskrivs vad du kan skapa med Formify API och webhooks, samt vad som krävs för detta. API-dokumentationen och API-referensen är avsedda för utvecklare och innehåller information om alla slutpunkter, parametrar och kodexempel.
