Guider / Automation

Fortnox API: så kommer ni igång

Uppdaterad

Kort svar: Fortnox API låter andra system läsa och skriva data i Fortnox, till exempel fakturor, kunder, artiklar och verifikationer. För att bygga en integration behöver ni ett utvecklarkonto, en registrerad integration med de behörigheter (scopes) ni behöver och inloggning via OAuth2. Företaget som använder integrationen behöver Fortnox integrationslicens. Finns det redan en app i Fortnox integrationsmarknad som gör jobbet, börja där.

Vill ni hellre få kopplingen byggd än bygga den själva? Då är det en Fortnox-integration vi tar fram åt er till fast pris. Den här guiden är för er som vill förstå API:et eller bygga själva.

Vad används Fortnox API till?

API:et är vägen in i Fortnox för allt som inte är en människa vid tangentbordet. Typiska exempel:

  • Webbshop: order från Shopify eller WooCommerce blir fakturor eller order i Fortnox.
  • CRM: kunder och avslut i HubSpot eller Pipedrive synkas med kundregistret.
  • Betalningar: inbetalningar från en betalleverantör matchas mot fakturor.
  • BI och rapporter: bokföring och fakturor hämtas till ett datalager eller Power BI.
  • Egna system: ett affärssystem eller en intern databas som behöver prata med bokföringen.
  • AI-assistenter: MCP-kopplingar som låter Claude eller ChatGPT ställa frågor till Fortnox. Läs mer i Fortnox MCP.

Så fungerar autentiseringen

Fortnox använder OAuth2. Förenklat går det till så här:

  1. Användaren skickas till Fortnox, loggar in och godkänner vilka delar av Fortnox integrationen får nå.
  2. Integrationen får en kod som är giltig i tio minuter och kan användas en gång.
  3. Integrationen byter koden mot en access token och en refresh token, med sitt Client-ID och Client-Secret.
  4. Access token används vid varje anrop och gäller i en timme.
  5. När den gått ut hämtas en ny med refresh token, som gäller i 45 dagar. Samtidigt kommer en ny refresh token och den gamla slutar fungera.

Det sista är en vanlig felkälla. Integrationen måste spara den nya refresh token varje gång. Går den förlorad måste användaren godkänna kopplingen igen.

För integrationer med ett servicekonto, som inte är knutet till en viss person, erbjuder Fortnox också Client Credentials. Då hämtar integrationen en ny access token med Client-ID, Client-Secret och bolagets TenantId, utan att hantera refresh tokens.

Ett anrop ser i princip ut så här:

GET https://api.fortnox.se/3/invoices
Authorization: Bearer <access token>

Scopes: behörigheter per område

Varje integration väljer scopes, alltså vilka områden i Fortnox den får nå. Exempel:

Scope Ger tillgång till
invoice Kundfakturor
customer Kundregister
article Artiklar
order Order
bookkeeping Verifikationer och konton

Tre saker att veta:

  • Alla scopes ger både läs- och skrivåtkomst. Det finns inget läsläge i API:et.
  • Bolaget måste ha licens för modulen. Utan rätt licens når integrationen inte resursen, även med rätt scope. invoice och article kräver till exempel licens för Order eller Kundfaktura, och bookkeeping kräver Bokföring eller Kundfaktura.
  • Nya scopes kräver nytt godkännande. Befintliga kopplingar behåller sina gamla scopes tills användaren godkänner igen.

Välj så få scopes som möjligt. Det är både bättre säkerhet och enklare att förklara för den som ska godkänna.

Vad en integration behöver

Hos er som bygger:

  • Utvecklarkonto. Registrera er hos Fortnox. Är ni redan kund kan support lägga till utvecklarportalen utan kostnad.
  • En registrerad integration. Skapas i utvecklarportalen. Där väljer ni namn och scopes och får Client-ID och Client-Secret.
  • Redirect URI. Adressen dit Fortnox skickar användaren efter godkännandet.
  • Testdatabaser. I utvecklarportalen kan ni skapa upp till 30 testbolag samtidigt. Testa alltid där först.

Hos företaget som använder integrationen:

  • Fortnox integrationslicens. 189 kr i månaden enligt Fortnox, oavsett hur många integrationer ni kopplar.
  • Licens för modulerna som integrationen ska nå, till exempel Bokföring eller Kundfaktura.
  • En användare som godkänner kopplingen och de scopes den ber om.

Rate limits

Fortnox tillåter 300 anrop per minut per integration och bolag. Gränsen mäts i ett glidande fönster på fem sekunder, vilket ger 25 anrop per fem sekunder. Går ni över får ni HTTP 429 tills snittet är nere igen. Gränsen är kopplad till access token, inte IP-adress.

För vanliga flöden räcker det gott. Det blir en fråga vid stora synkar, som att läsa in hela artikelregistret eller flera års verifikationer. Bygg in väntetid och omförsök från början.

Händelser i stället för att fråga hela tiden

I stället för att fråga Fortnox var femte minut om något ändrats kan integrationen lyssna på händelser via Fortnox WebSockets. Det finns ämnen för bland annat fakturor, kunder, artiklar, order, leverantörsfakturor och verifikationer. Händelsen säger vad som hänt, och integrationen hämtar sedan det den behöver. Missade händelser kan spelas upp i upp till 14 dagar. Det sparar anrop och ger snabbare flöden.

Behöver ni även data från andra källor? Se Bolagsverkets API för företagsuppgifter och SIE-verktyget för att öppna och kontrollera bokföringsfiler.

Köpa en app eller bygga eget?

Fortnox integrationsmarknad har färdiga appar för många vanliga behov, som webbshoppar, betalningar och kvittohantering. En färdig app är nästan alltid snabbare att komma igång med.

Köp en app när:

  • den gör det ni behöver utan omvägar
  • flödet är standard, till exempel order från en vanlig webbshop
  • ni inte vill äga och underhålla kod

Bygg eget när:

  • ingen app hanterar era regler, till exempel särskild kontering, prislogik eller flera bolag
  • flera system ska samspela i samma flöde
  • ni vill ha full kontroll över felhantering och var data behandlas
  • licenskostnaderna för färdiga appar växer med volymen

Ett mellanläge är no-code-verktyg som Make eller Zapier, som båda har Fortnox-kopplingar. Vi jämför alternativen i Zapier, Make eller egen integration? och beskriver hur vi ser på ägande och drift i Bygga egna integrationer och system.

Vill ni sälja er integration till andra Fortnox-kunder kan den publiceras i integrationsmarknaden, antingen som en app kunderna köper via Fortnox eller som en app ni säljer själva och kunderna aktiverar. För en intern integration behövs ingen publicering.

Vill ni använda Power Automate mot Fortnox? Läs Power Automate och Fortnox. Behöver ni avstämning av betalutbetalningar mot bokföringen? Se Klarna, Stripe och Swish.

Checklista

  1. Beskriv flödet. Vilka data ska flytta, åt vilket håll och hur ofta?
  2. Leta efter en färdig app i Fortnox integrationsmarknad.
  3. Kontrollera licenserna: integrationslicens och moduler för de scopes ni behöver.
  4. Skapa utvecklarkonto och integration och välj så få scopes som möjligt.
  5. Bygg mot ett testbolag, aldrig mot den riktiga bokföringen först.
  6. Hantera tokens rätt: spara den nya refresh token varje gång, eller använd Client Credentials för servicekonton.
  7. Bygg in rate limits och omförsök från dag ett.
  8. Logga och larma när något går fel, så att det inte upptäcks vid bokslutet.
  9. Dokumentera vem som äger integrationen och var den körs.

Vår sida om Fortnox-integration beskriver hur vi bygger och driftar integrationer mot Fortnox. Vill ni gå igenom ert flöde och se om en app räcker eller om ni behöver något eget? Boka en kostnadsfri genomgång på 30 minuter.

Källor

Kontrollerat oktober 2026.

Vanliga frågor

Kostar Fortnox API något?

Själva utvecklarkontot är gratis enligt Fortnox, och är ni redan kund kan support lägga till utvecklarportalen. Företaget som ska använda integrationen behöver Fortnox integrationslicens, som kostar 189 kr i månaden oavsett antal integrationer, och licens för de moduler integrationen ska nå.

Vilka Fortnox-appar och integrationer finns redan?

Fortnox integrationsmarknad har färdiga appar för många vanliga behov, som webbshoppar, betalningar och kvittohantering. Kontrollera där först, eftersom en färdig app nästan alltid är snabbast att komma igång med. Vad en egen integration kostar beskriver vi i [Vad kostar en Fortnox-integration?](/guider/vad-kostar-en-fortnox-integration)

Kan vi få en API-nyckel med bara läsrättigheter?

Nej. Fortnox skriver att alla scopes ger både läs- och skrivåtkomst och att det inte går att bara läsa via API:et. Begränsa i stället antalet scopes och bygg integrationen så att den bara gör det den ska.

Hur många anrop får vi göra?

Fortnox anger 300 anrop per minut per integration och bolag, mätt i ett glidande fönster på fem sekunder. Det motsvarar 25 anrop per fem sekunder. Går ni över får ni svar med HTTP-kod 429.

Måste integrationen publiceras i Fortnox integrationsmarknad?

Nej. En integration som bara används av ert eget företag behöver inte publiceras. Publicering är till för den som vill sälja eller erbjuda integrationen till andra Fortnox-kunder.

Har ni ett problem som borde lösas bättre?

Berätta vad ni vill uppnå. Vi hjälper er att avgöra vad som är värt att bygga och hur ni får det i drift.