Überblick
Bauhow über die REST-API an eigene Systeme anbinden: Kontakte, Vorgänge, Projekte und Projektmodule.
Mit der Bauhow-API verbinden Sie Ihr ERP, CRM, Ihre Buchhaltung oder Ihre Website mit Ihrem Workspace. Die API ist eine REST-API mit JSON und einer OpenAPI-Beschreibung.
API-Referenz
Alle Endpunkte mit Parametern, Antworten und Code-Beispielen.
Zugang anfragen
Die API für Ihren Workspace freischalten lassen.
Was die API kann
| Bereich | Möglichkeiten |
|---|---|
| Kontakte und Gebäude | Kontakte samt eigener Felder lesen, anlegen, ändern und löschen; Gebäude lesen und anlegen |
| Vorgänge | Vorgänge lesen, anlegen, in andere Phasen verschieben, gewinnen oder verlieren, archivieren und löschen; Phasen und Projektarten lesen; Wahrscheinlichkeit und „Kritisch nach“ einer Phase setzen |
| Projekte | Projekte lesen, anlegen, umbenennen, Status setzen, archivieren und wiederherstellen |
| Projektmodule | Module eines Projekts lesen und ihre Eingaben ändern, zum Beispiel im Förderrechner |
| Photovoltaik | PV-Planungen eines Projekts lesen und anlegen |
Basis-URL:
https://app.bauhow.com/api/v1API-Schlüssel anlegen
Nach der Freischaltung legen Owner und Admins Schlüssel an:
Einstellungen öffnen
Öffnen Sie Einstellungen → Workspace → API.
Schlüssel erstellen
Klicken Sie auf Schlüssel erstellen, vergeben Sie einen Namen und wählen Sie pro Bereich Kein Zugriff, Lesen oder Lesen und schreiben. Legen Sie fest, wie lange der Schlüssel gültig ist.
Schlüssel kopieren
Kopieren Sie den Schlüssel sofort. Er wird nur einmal angezeigt. Bewahren Sie ihn sicher auf, zum Beispiel in einem Passwortmanager.
Senden Sie den Schlüssel bei jeder Anfrage im Header Authorization:
curl https://app.bauhow.com/api/v1/projects \
-H "Authorization: Bearer bh_…"Berechtigungen
Ein Schlüssel handelt mit den Rechten des Mitglieds, das ihn erstellt hat, beschränkt auf die gewählten Bereiche. Sieht dieses Mitglied nur zugewiesene Kontakte oder Projekte, gilt das auch für den Schlüssel. Plan-Limits gelten wie in der App.
| Bereich | Lesen | Lesen und schreiben |
|---|---|---|
| Kontakte und Gebäude | contacts:read |
contacts:write |
| Vorgänge | deals:read |
deals:write |
| Projekte, Module und PV-Planungen | projects:read |
projects:write |
Unter Einstellungen → Workspace → API sehen Owner und Admins alle Schlüssel mit Ersteller, Ablaufdatum und letzter Nutzung. Mit Widerrufen sperren Sie einen Schlüssel sofort.
Listen und Synchronisation
Die Listen für Kontakte, Gebäude, Vorgänge und Projekte liefern { "data": [...], "hasMore": true } und unterstützen limit (bis 500), offset und updatedSince. Mit updatedSince holen Sie nur Datensätze, die sich seit einem Zeitpunkt geändert haben. Die übrigen Listen (Module, PV-Planungen, Kontaktfelder, Phasen, Projektarten) sind kurz und liefern immer alle Einträge als { "data": [...] }.
curl "https://app.bauhow.com/api/v1/contacts?updatedSince=2026-10-01T00:00:00Z&limit=100" \
-H "Authorization: Bearer bh_…"Eigene Kontaktfelder stehen im Objekt fields, nach Feld-Schlüssel. Welche Felder es gibt, liefert GET /v1/contact-fields.
Fehler
| Status | Bedeutung |
|---|---|
400 |
Ungültige Eingabe, zum Beispiel ein unbekanntes Kontaktfeld |
401 |
Schlüssel fehlt, ist widerrufen oder abgelaufen |
403 |
API für den Workspace nicht freigeschaltet, Bereich fehlt, Rolle erlaubt die Aktion nicht oder Plan-Limit erreicht |
404 |
Datensatz nicht gefunden oder für den Schlüssel nicht sichtbar |