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

# Create Lead

> Add a single row to a lead list. Workspace-wide dedup on email and normalised LinkedIn URL is on by default.

```bash theme={null}
curl -X POST https://api.opennous.cloud/v2/leads \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "list_id": "LIST_UUID",
    "email": "sarah@acme.com",
    "name": "Sarah Chen",
    "company": "Acme",
    "linkedin_url": "https://linkedin.com/in/sarah-chen",
    "fields": { "title": "VP Sales", "industry": "SaaS" }
  }'
```

## Body

<ParamField body="list_id" type="string" required>
  UUID of the destination lead list.
</ParamField>

<ParamField body="email" type="string">
  Email. At least one of `email` or `linkedin_url` is required.
</ParamField>

<ParamField body="linkedin_url" type="string">
  LinkedIn profile URL.
</ParamField>

<ParamField body="name" type="string" />

<ParamField body="company" type="string" />

<ParamField body="send_variant" type="string" />

<ParamField body="is_repeat_contact" type="boolean" />

<ParamField body="features" type="object">
  Feature snapshot the Scorecard reads. Free-form JSON.
</ParamField>

<ParamField body="fields" type="object">
  Values for the list's user-defined columns. Free-form JSON.
</ParamField>

<ParamField body="importDuplicates" type="boolean" default="false">
  Force-insert even if the email or LinkedIn URL is already in the workspace.
</ParamField>

## Response

```json theme={null}
{ "inserted": 1, "skipped": 0, "duplicate_skipped": 0 }
```