Postman & immoJUMP: einrichten für die immoJUMP API

Posted on by Luisa

Wenn du die immoJUMP API testen, debuggen oder in Automationen (z. B. n8n, Make, eigene Scripts) integrieren willst, ist Postman der schnellste Weg zu sauberen Requests und reproduzierbaren Ergebnissen. Das passt zum immoJUMP-Ansatz: weniger Tool-Chaos, mehr Struktur.

Was du brauchst

  • Postman installiert (Desktop oder Web)
  • API-Zugang zu immoJUMP (Token / API-Key): https://immojump.de/ng/settings/api-access
  • Base-URL deiner Umgebung (z. B. https://… für Prod oder Beta)
    • PROD: https://immojump.de/

1) In Postman eine Collection anlegen

  1. Postman öffnen → Collections → New Collection
  2. Name z. B.: immoJUMP API
  3. Optional: Ordner anlegen wie Auth, Units, Contacts, Tasks (später praktisch fürs Team)

2) Environment anlegen (damit du nicht überall URLs/Tokens kopierst)

  1. Environments → New
  2. Name z. B.: immoJUMP - Staging (und später immoJUMP - Prod)
  3. Variablen anlegen:
  • baseUrl → z. B. https://api.immojump.de
  • token → dein API-Token (als Current Value setzen)

Tipp: Wenn mehrere Mandanten/Workspaces relevant sind, kannst du zusätzlich Variablen wie tenantId oder accountId anlegen – nur wenn die immoJUMP Doku sie wirklich verlangt.

3) Authentifizierung sauber setzen (Best Practice)

Variante A: Bearer Token (häufigster Fall)

  1. In deiner Collection → Tab Authorization
  2. Type: Bearer Token
  3. Token: {{token}}

Damit erbt jeder Request in der Collection automatisch die Auth-Einstellung.

Organisation im Header setzen

Welche Variante bei dir gilt, steht in deiner immoJUMP API-Doku.

4) Deinen ersten Request bauen

  1. New Request in der Collection
  2. Methode: GET
  3. URL: {{baseUrl}}/<endpoint-aus-der-doku>

Header (typisch):

  • Accept: application/json
  • Bei POST/PUT zusätzlich: Content-Type: application/json

Wenn du nicht weißt, welcher Endpoint „der kleinste“ ist: Nimm einen, der garantiert keine Seiteneffekte hat (z. B. /me, /health, /ping – sofern vorhanden) und starte damit.

5) Schnell-Check: Was bedeuten die häufigsten Fehler?

  • 401 Unauthorized → Token fehlt / falsch / falsch platziert (Bearer vs Header)
  • 403 Forbidden → Token ok, aber Rechte fehlen (Scope/Rolle/Account)
  • 404 Not Found → Base-URL oder Pfad falsch (oft /api/v1/... vs /v1/...)
  • 415 Unsupported Media Type → Content-Type: application/json fehlt bei Body-Requests

Das ist genau die Art von „Gerüst“, die immoJUMP stark macht: klar, wiederholbar, skalierbar.

— Andi