Add Leads

Create one or more leads within the authenticated project.

Endpoint

POST /api/leads/add

Authentication

Requires a valid Bearer JWT. Leads are associated with the project_id from the token.

Request body

A JSON array of lead objects:

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

Field	Type	Required	Description
first_name	string	yes	Lead's first name.
last_name	string	yes	Lead's last name.
phone_number	string	yes	E.164 phone number, e.g. +49....

Behavior

• All leads are associated with the project from the JWT token.
• At least one lead must be provided.

Success response

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

Error responses

Missing / invalid token

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

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

Invalid request format

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

No leads provided

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

Database error

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