# Create a lead

### Create a lead

`POST /api/v1/leads`

Operation ID: `createLead`

**Request body** (required)

- `identities` (object, required)
  - `linkedin` (string, optional)
  - `instagram` (string, optional)
- `timezone` (string, required)
- `firstName` (string, optional)
- `lastName` (string, optional)
- `companyName` (string, optional)
- `companyDomain` (string, optional)
- `jobTitle` (string, optional)
- `email` (string, optional)
- `imageUrl` (string, optional)
- `properties` (object, optional)

**201**: Created lead.

- `lead` (object, required)
  - `id` (string · uuid, required)
  - `firstName` (string | null, required)
  - `lastName` (string | null, required)
  - `companyName` (string | null, required)
  - `companyDomain` (string | null, required)
  - `jobTitle` (string | null, required)
  - `email` (string | null, required)
  - `imageUrl` (string | null, required)
  - `timezone` (string, required)
  - `identities` (object[], required)
  - `liveEnrollment` (object | null, required)
    - `campaignId` (string · uuid, required)
    - `campaignName` (string, required)
    - `status` ("active" | "waiting" | "completed" | "stopped" | "failed", required)
  - `createdAt` (string · date-time, required)
  - `updatedAt` (string · date-time, required)
  - `properties` (object, required)
  - `enrollments` (object[], required)

**Errors**

- `400`: Bad request
- `401`: Unauthorized: missing or invalid API key
- `403`: Forbidden
- `404`: Not found
- `422`: Invalid request payload