---
title: "Create lead"
method: POST
path: "/user/lead"
tags: ["Leads"]
---

# Create lead

`POST /user/lead`

## Request

- Base URL: `https://app.famulor.de/api`
- URL: `https://app.famulor.de/api/user/lead`
- Auth: HTTP bearer

Add a new lead to your Famulor outbound calling campaign via API. Submit contact information, custom variables and trigger AI voice agent calls.

[Docs](https://docs.famulor.io/api-v1/leads/create)

## Request body

- object
  - `phone_number` string, required: Contact phone number in E.164 format (example: +1234567890)
  - `campaign_id` integer, required: The campaign ID where this lead should be added
  - `variables` object: Custom data fields to associate with this lead
    - `customer_name` string: Customer's full name
    - `email` string: Customer's email address
  - `allow_dupplicate` boolean: Permit creating duplicate leads within the same campaign (default: false)
  - `secondary_contacts` object[]: Additional contact persons linked to this lead
    - `phone_number` string, required: Secondary contact's phone number in E.164 format
    - `variables` object: Custom variables for the secondary contact
      - `customer_name` string: Secondary contact's name
      - `email` string: Secondary contact's email

## Response `200`

Response

- object
  - `message` string: Success confirmation message
  - `data` object: The created lead object with all associated data
    - `id` integer: Unique identifier for the new lead
    - `campaign_id` integer: Campaign identifier this lead is assigned to
    - `phone_number` string: Lead's contact number in E.164 format
    - `variables` object: Custom variables stored with the lead
      - `customer_name` string: Customer's name
      - `email` string: Customer's email address
    - `status` string: Current lead status
    - `created_at` string: Creation timestamp
    - `updated_at` string: Last modification timestamp
    - `campaign` object: Campaign details for this lead
      - `id` integer: Campaign identifier
      - `name` string: Campaign name
    - `secondary_contacts` object[]: List of secondary contacts created with this lead
      - `id` integer: Secondary contact identifier
      - `phone_number` string: Secondary contact phone number in E.164 format
      - `variables` object: Variables for the secondary contact
      - `status` string: Secondary contact status
      - `created_at` string: Secondary contact creation timestamp
      - `updated_at` string: Secondary contact last update timestamp

## Other responses

- `401`: Fehlender oder ungültiger API-Key.
- `422`: Die Anfrage ist inhaltlich ungültig.

---

[API](https://skmtc.dev/famulor/apis/famulor-api.md) · [All operations](https://skmtc.dev/famulor/apis/famulor-api/llms.txt) · [OpenAPI document](https://skmtc.dev/famulor/apis/famulor-api/revisions/3b938c370721?raw)