Integrationer
API og integrationer til boligforeningen
NaboPortalen, driftssystemet til danske boligforeninger, har et åbent API. Foreningen kan koble administratorens system, en infoskærm i opgangen eller sine egne værktøjer på, så data ikke skal tastes to gange. Bestyrelsen bestemmer præcis, hvad hvert system må se og gøre, og API'et er en del af abonnementet.
Når foreningens systemer skal tale sammen
De fleste foreninger har flere systemer end NaboPortalen: administratorens, regnskabets, en hjemmeside eller en skærm i opgangen. API'et er vejen imellem dem.
Beboerlisten følger administratoren
Når administratoren registrerer en ind- eller fraflytning, kan deres system oprette beboeren eller lukke den gamle konto i NaboPortalen. Så er beboerlisten ajour, uden at bestyrelsen skal gøre det i hånden.
Infoskærm i opgangen
En skærm ved postkasserne kan hente opslagstavlen og kommende arrangementer og vise dem, så beboere uden smartphone også ser det vigtigste. Nøglen får kun lov at læse, ikke at skrive.
Besked, når noget sker
Med webhooks får et andet system besked, når en sag lukkes, en booking godkendes eller en vare er ved at slippe op. Det kan fx starte en indkøbsordre eller en besked i et automatiseringsværktøj som Zapier eller Make.
Det er eksempler på, hvad API'et gør muligt. Der er ingen færdigbyggede koblinger til navngivne administrations- eller økonomisystemer; koblingen bygges i det andet system, af dem der leverer det, eller af en udvikler foreningen vælger.
De samme moduler som i systemet
API'et bygger på de samme regler som web-appen. En booking via API'et skal overholde de samme bookingregler, og en sag oprettet af et andet system får samme historik som alle andre sager.
Sager
Læs og skrivLæs sager, beskeder og kategorier. Opret sager, skriv beskeder, skift status og luk med løsningstype og brugte dele.
Beboere, boliger og husstande
Læs og skrivHent boliger og beboere, og hold dem opdateret ved ind- og fraflytning. Kontaktoplysninger kræver en særskilt tilladelse.
Booking
Læs og skrivRessourcer, ledige tider og bookinger. Opret, aflys, godkend og afvis efter de samme regler som i systemet.
Arrangementer
Læs og skrivOpret og opdatér arrangementer, og tilmeld eller afmeld beboere.
Opslagstavle og feed
Læs og skrivHent opslag til fx en infoskærm, og publicér opslag fra et andet system.
Dokumenter
Læs og skrivSøg i publicerede dokumenter med tidsbegrænsede downloadlinks, og styr dokumentstatus fra fx et signeringsforløb.
Lager og servicebog
Læs og skrivLagre, varer, lav beholdning og boligens servicehistorik. Justér beholdning fra en scanner eller et indkøbssystem.
Årshjul
Læs og skrivHent opgaver med ansvar og frister, og markér dem udført eller tildel dem.
Grupper, leverandører og nøgletal
LæsGrupper med medlemmer, leverandørregistret og driftens nøgletal til fx Excel eller Power BI.
Et system kan også sende notifikationer og indkaldelser til beboerne. Alt, hvad et andet system skriver, står i historikken som "[Integration]" med nøglens navn, så det altid kan ses, hvad der kom udefra. Den fulde liste over endpoints står i API-dokumentationen.
Andre systemer får besked med det samme
I stedet for at et system spørger NaboPortalen hvert femte minut, om der er nyt, sender NaboPortalen selv besked, når der sker noget.
- Over 40 hændelser på tværs af sager, beboere, booking, arrangementer, opslag, dokumenter, lager og årshjul. Foreningen vælger, hvilke hver modtager skal have.
- Ingen persondata i beskeden. En webhook siger kun, hvad der skete og med hvilket id. Modtageren henter detaljerne med sin egen nøgle og sine egne rettigheder.
- Signeret. Hver besked er signeret, så modtageren kan kontrollere, at den kommer fra NaboPortalen og ikke er sendt igen af en anden.
- Prøver igen. Er modtageren nede, prøver NaboPortalen igen over det næste døgn. Bliver det ved med at fejle, slås webhooken fra, og bestyrelsen får besked.
- Leverancelog. Bestyrelsen kan se hver afsendt besked, svaret fra modtageren og sende en besked igen.
Ingen adgang, før foreningen giver den
Bestyrelsen er dataansvarlig, og derfor er det bestyrelsen, der udsteder nøglerne under Integrationer. Opgaven kan gives videre til fx viceværten, hvis der er et konkret behov.
Der er omkring 70 enkeltrettigheder, og ingen er valgt på forhånd. At læse sager og at oprette sager er to forskellige rettigheder, og beboeres telefon og e-mail kræver sin egen. En nøgle får kun det, I krydser af.
En nøgle vises én gang og gemmes ikke i læsbar form. Den udløber senest efter 24 måneder, kan låses til bestemte IP-adresser, kan skiftes ud og kan tilbagekaldes med det samme. Bestyrelsen får besked, før en nøgle udløber.
Hvert kald står i en adgangslog, som bestyrelsen kan se, og som gemmes i 13 måneder. Bruges en nøgle usædvanligt, fx fra mange nye adresser eller til mange beboeropslag, får bestyrelsen en advarsel.
En nøgle virker kun for den forening, den er udstedt i. Den kan ikke oprette andre nøgler, ændre roller, give nogen bestyrelsesadgang eller sætte adgangskoder. Mere om databehandling står under sikkerhed og drift og i privatlivspolitikken.
Et almindeligt REST-API
Skal du bygge koblingen, er der ingen særlige værktøjer at lære. API'et følger kendte standarder og er dokumenteret offentligt.
- JSON over HTTPS på foreningens eget domæne, versioneret under
/api/v1 - Dokumentation genereret fra koden som OpenAPI 3.1 på docs.naboportalen.dk
- Cursor-paginering og
updated_sincepå lister, så du kun henter det, der er ændret Idempotency-Keypå skrivekald, så et genforsøg ikke opretter dubletter- Fejl som Problem Details (RFC 9457) med danske fejltekster
- Webhooks signeret med HMAC-SHA256, med kodeeksempler i dokumentationen
- En sandkasse med fiktive data, der nulstilles hver nat, til at prøve af uden at røre rigtige beboere
curl https://jeres-forening.naboportalen.dk/api/v1/tickets?filter[status]=open \
-H "Authorization: Bearer nbp_live_…"
{
"data": [
{
"public_id": "01JA7Q…",
"title": "Utæt vandhane i vaskerum",
"status": "open",
"category": { "slug": "vvs", "label": "VVS" },
"created_at": "2026-10-14T08:12:00+02:00"
}
],
"meta": { "next_cursor": "…" }
}Nøglen får du af foreningens bestyrelse. Bygger du en integration uden at høre til en forening, så skriv til info@naboportalen.dk for en nøgle til sandkassen.
Det kan API'et ikke i dag
Hellere sige det her end at I opdager det midt i et projekt.
Der er ingen indbygget kobling til navngivne administrations- eller økonomisystemer. API'et er åbent, men koblingen skal bygges i det andet system.
Beboernes chat kan ikke hentes med en API-nøgle, og et andet system kan hverken sætte adgangskoder eller gøre nogen til bestyrelsesmedlem. Den slags sker kun i NaboPortalen selv.
Dokumenter kan hentes og styres via API'et, men nye filer og billeder på sager uploades stadig i NaboPortalen. Upload via API'et er det næste, der bygges.
API'et er til systemer, foreningen giver adgang med en nøgle. Beboere kan ikke logge ind i andre tjenester med deres NaboPortalen-konto.
Ofte stillede spørgsmål
Koster API'et ekstra?+
Nej. API'et og webhooks er en del af abonnementet som alle andre funktioner. Prisen afhænger alene af antallet af boliger - se priser.
Hvem kan oprette en API-nøgle?+
Bestyrelsen, under Integrationer i NaboPortalen. Bestyrelsen kan give opgaven videre til fx viceværten. Beboere kan ikke oprette nøgler, og der findes ingen nøgler, før foreningen selv opretter dem.
Kan et andet system se beboernes telefonnumre og e-mails?+
Kun hvis bestyrelsen udtrykkeligt giver nøglen den særskilte tilladelse til kontaktoplysninger. Den er fravalgt som standard, og alle kald står i adgangsloggen.
Har I en færdig integration til vores administrator?+
Nej, ikke til navngivne systemer. API'et er åbent og dokumenteret, så administratoren eller deres leverandør kan bygge koblingen. Vi hjælper gerne med at vise, hvad API'et kan.
Hvor er dokumentationen?+
På docs.naboportalen.dk. Den er offentlig og genereret direkte fra koden, så den altid passer med API'et. Der er også en sandkasse med fiktive data til at prøve af.
Skal jeres forening kobles sammen med et andet system?
Book en gennemgang, så viser vi Integrationer i NaboPortalen og taler om, hvad jeres administrator eller leverandør skal bruge.