Leads hinzufügen

Erstellt einen oder mehrere Leads innerhalb des authentifizierten Projekts.

Endpunkt

POST /api/leads/add

Authentifizierung

Erfordert ein gültiges Bearer-JWT. Leads werden mit der project_id aus dem Token verknüpft.

Request-Body

Ein JSON-Array von Lead-Objekten:

[
  {
    "first_name": "John",
    "last_name": "Doe",
    "phone_number": "+49123456789"
  },
  {
    "first_name": "Jane",
    "last_name": "Smith",
    "phone_number": "+49123456780"
  }
]

Feld	Typ	Erforderlich	Beschreibung
first_name	string	ja	Vorname des Leads.
last_name	string	ja	Nachname des Leads.
phone_number	string	ja	Telefonnummer im E.164-Format, z. B. +49....

Verhalten

• Alle Leads werden mit dem Projekt aus dem JWT-Token verknüpft.
• Es muss mindestens ein Lead angegeben werden.

Erfolgsantwort

{
  "success": true,
  "message": "Leads added successfully",
  "leads": [
    {
      "id": "123",
      "first_name": "John",
      "last_name": "Doe",
      "phone_number": "+49123456789",
      "project_id": "project_abc"
    }
  ]
}

Fehlerantworten

Fehlendes / ungültiges Token

{ "success": false, "message": "Authorization header missing", "leads": null }

{ "success": false, "message": "Invalid or expired authentication token", "leads": null }

Ungültiges Request-Format

{ "success": false, "message": "Invalid request format: ...", "leads": null }

Keine Leads angegeben

{ "success": false, "message": "At least one lead must be provided", "leads": null }

Datenbankfehler

{ "success": false, "message": "Failed to add leads: ...", "leads": null }