> ## Documentation Index
> Fetch the complete documentation index at: https://docs.deal-pipe.de/llms.txt
> Use this file to discover all available pages before exploring further.

# Projekte und Einheiten per API anlegen

> Schreiboperationen und synchrone Sammelimporte verwenden.

## Projekt erstellen

Senden Sie `POST /projects` mit einem Namen und den gewünschten Adressfeldern. Speichern Sie die zurückgegebene `project.id`. Das frühere Projektfeld `visibility` wird angenommen, aber ignoriert; Sichtbarkeit gehört zur Einheit.

```json theme={null}
{
  "name": "Beispielprojekt",
  "street": "Musterstraße",
  "houseNumber": "10",
  "postalCode": "10115",
  "city": "Berlin"
}
```

## Einheiten hinzufügen

Eine einzelne Einheit erstellen Sie mit `POST /projects/{id}/properties`. Für mehrere Einheiten verwenden Sie `POST /projects/{id}/imports` mit folgendem Body:

```json theme={null}
{
  "units": [
    {
      "unitIdentifier": "WE-01",
      "unitNumber": "1",
      "etage": 1,
      "wohnflaecheQm": "64.50",
      "kaufpreis": "320000.00",
      "visibility": "offline",
      "status": "frei"
    }
  ]
}
```

Ein Sammelimport akzeptiert 1 bis 200 Einheiten. `etage` ist eine ganze Zahl; `etageLabel` kann die angebotene Etagenbezeichnung aufnehmen. Verwenden Sie Dezimalpunkte für numerische Strings.

## Ergebnis behandeln

Der Import arbeitet in v1 synchron, antwortet aber mit `202` und `status: "completed"`. Speichern Sie `importRunId`; über `GET /imports/{id}` lesen Sie den Status. Tarif- und Online-Kontingente gelten auch für API-Importe.

Die API bietet für diese POST-Aufrufe keinen dokumentierten Idempotency-Key und kein Upsert. Ein erneuter Aufruf kann weitere Datensätze erzeugen. Prüfen Sie nach einem Verbindungsabbruch zuerst den Bestand.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.