---
title: "Überblick"
description: "Bauhow über die REST-API an eigene Systeme anbinden: Kontakte, Vorgänge, Projekte und Projektmodule."
---

:::warning
**Die API ist im Early Access.** Sie wird pro Workspace auf Anfrage freigeschaltet. Bitte fragen Sie den Zugang über den [Bauhow-Support](https://bauhow.com/support) an, bevor Sie eine Integration bauen. Bis dahin ist die Einstellungsseite **API** nicht sichtbar, Sie können also noch keine Schlüssel anlegen. Anfragen ohne gültigen Schlüssel beantwortet die API mit `401`, Schlüssel eines nicht freigeschalteten Workspaces mit `403`.
:::

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](/de/api/reference)**

Alle Endpunkte mit Parametern, Antworten und Code-Beispielen.

**[Zugang anfragen](https://bauhow.com/support)**

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:

```text
https://app.bauhow.com/api/v1
```

## API-Schlüssel anlegen

Nach der Freischaltung legen Owner und Admins Schlüssel an:

1. **Einstellungen öffnen**

    Öffnen Sie **Einstellungen → Workspace → API**.

2. **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.

3. **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`:

```bash
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` |

:::info
Verlässt das Mitglied den Workspace oder wird es deaktiviert, funktioniert der Schlüssel nicht mehr. Legen Sie Schlüssel für dauerhafte Integrationen daher von einem Konto an, das bestehen bleibt.
:::

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": [...] }`.

```bash
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 |
