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åerEnkel elektronisk signatur med bläck (SES) och avancerad elektronisk signatur (AES) med pass och videoselfie enligt eIDAS
InbjudningarE-post, SMS eller WhatsApp
Språk i inbjudanEngelska, svenska och spanska
Signerad PDFFörsedd med ett godkänt certifikat från en leverantör som finns med på EU:s lista över betrodda certifikatutfärdare
Var uppgifterna lagrasDokument och data lagras inom EU, med Sverige som huvudsaklig region (där dina data lagras)
KostnadKom 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)
AutentiseringOAuth 2.0 eller API-nyckel
FormatOpenAPI, Markdown och llms.txt
krediter per sändningDokument 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

EvenemangNär det skickas
document.createdEtt dokument har skapats och skickats för underskrift.
document.openedDokumentet har öppnats.
document.signedEn undertecknare har undertecknat. Datamängden innehåller även signeeId.
document.completedAlla parter har undertecknat och dokumentet är förseglat.
document.revokedDokumentet har återkallats.
document.deletedDokumentet 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

  1. Skapa ett gratis Formify-konto.
  2. Be din utvecklare att läsa API-referensen.
  3. Skapa inloggningsuppgifter: OAuth 2.0 eller en API-nyckel i Formify-appen under Inställningar, Integration.
  4. Registrera en webhook till den adress som ditt system lyssnar på.

Produktionschecklista

Vad fungerar, och hur?

Vad du vill haStatusSå här fungerar det
Att veta när ett dokument är undertecknat eller förseglatBehöver en utvecklareWebhooks document.signed och document.completed
Kontrollera att webhooken verkligen kommer från FormifyBehöver en utvecklareHMAC-SHA256 med slutpunktens whsec_ hemlighet
Få aviseringar utan hjälp av en utvecklareFungerar direkt ur förpackningenI Make, med funktionen ”Visa färdiga dokument”
Skicka tillsammans med passet och en videoselfieBehöver en utvecklareSignaturtyp signatureFaceLiveness
Ladda ner den undertecknade PDF-filenBehöver en utvecklareEn tidsbegränsad länk, giltig i 10 minuter
Webhooks för inställningar eller ändringar av kontotEj tillgängligtEndast dokumenthändelser stöds
Testa utan produktionsdataBehöver en utvecklaresk_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.

Relaterade integrationer