# Create a lead

`needleCreateLead`

Create a lead. Fails when an identity already belongs to a lead (the error data has that leadId); use needleUpsertLead to create-or-update. LinkedIn identity accepts john-doe, /in/john-doe, https://www.linkedin.com/in/john-doe, or a user id (ACoAAA…). Instagram accepts john-doe, @john-doe, or https://www.instagram.com/john-doe.

**Input**

- `identities` (object, required)
  - `linkedin` (string, optional): Public identifier (john-doe), /in/ path (/in/john-doe or in/john-doe), profile URL (https://www.linkedin.com/in/john-doe), or user id (ACoAAA…). Stored as the identifier, not the URL.
  - `instagram` (string, optional): Username (john-doe), handle (@john-doe), or profile URL (https://www.instagram.com/john-doe). Stored as the username without @.
- `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)