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

# Create lead

> Create a new lead in the Receptonic system

This endpoint allows you to create a new lead in the Receptonic system.

### Request body

**phone\_number** `string` *required*

The phone number of the lead in E.164 format (e.g. +1234567890)

**campaign\_id** `integer` *required*

The ID of the campaign to create the lead for

**variables** `object`

Custom variables for the lead. For **call** campaigns, use variables defined on your assistant (see [Call variables](https://docs.receptonic.com/ai-assistants/settings/prompt-and-tools.md#call-variables)). For **WhatsApp/SMS** campaigns, use the keys referenced by your template mapping or SMS body placeholders.

**Example variables (add your own)**

**customer\_name** `string`

e.g. the name of the customer

**email** `string`

e.g. the email of the customer

**allow\_dupplicate** `boolean`

Whether to allow duplicate leads in a campaign.

**secondary\_contacts** `array`

Call campaigns only. Extra phone numbers for the same lead. Rejected for WhatsApp/SMS campaigns.

**secondary\_contacts properties**

**phone\_number** `string` *required*

The phone number of the secondary contact in E.164 format

**variables** `object`

The variables to pass to the secondary contact

**variables properties**

**customer\_name** `string` (default: \<string>)

The name of the secondary contact

**email** `string` (default: \<string>)

The email of the secondary contact

### Response

**message** `string` (default: Lead created successfully)

The message of the response

**data** `object`

The lead data object

**data properties**

**id** `integer`

The unique ID of the created lead

**campaign\_id** `integer`

The ID of the campaign this lead belongs to

**phone\_number** `string`

The phone number of the lead in E.164 format

**variables** `object`

The variables associated with the lead

**variables properties**

**customer\_name** `string` (default: \<string>)

The name of the customer

**email** `string` (default: \<string>)

The email of the customer

**status** `string` (default: created)

The status of the lead

**created\_at** `string`

The timestamp when the lead was created

**updated\_at** `string`

The timestamp when the lead was last updated

**campaign** `object`

The campaign information

**campaign properties**

**id** `integer`

The id of the campaign

**name** `string`

The name of the campaign

**secondary\_contacts** `array`

Array of secondary contact leads associated with this lead

**secondary\_contacts properties**

**id** `integer`

The id of the secondary contact lead

**phone\_number** `string`

The phone number of the secondary contact in E.164 format

**variables** `object`

The variables associated with the secondary contact

**status** `string`

The status of the secondary contact

**created\_at** `string`

The created at date of the secondary contact

**updated\_at** `string`

The updated at date of the secondary contact

```json 200 Response theme={null}
{
  "message": "Lead created successfully",
  "data": {
    "id": 1,
    "campaign_id": 1,
    "phone_number": "+1234567890",
    "variables": {
      "customer_name": "John Doe",
      "email": "john.doe@example.com"
    },
    "status": "created",
    "created_at": "2025-06-30 11:53:20",
    "updated_at": "2025-06-30 11:53:20",
    "campaign": {
      "id": 1,
      "name": "My new campaign"
    },
    "secondary_contacts": [
      {
        "id": 2,
        "phone_number": "+1234567891",
        "variables": {
          "customer_name": "Jane Doe Secondary",
          "email": "jane.doe.secondary@example.com"
        },
        "status": "created",
        "created_at": "2025-06-30 11:53:20",
        "updated_at": "2025-06-30 11:53:20"
      },
      {
        "id": 3,
        "phone_number": "+1234567892",
        "variables": {
          "customer_name": "Bob Doe Office",
          "email": "bob.doe.office@example.com"
        },
        "status": "created",
        "created_at": "2025-06-30 11:53:20",
        "updated_at": "2025-06-30 11:53:20"
      }
    ]
  }
}
```


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