Needle LogoNeedle

Leads

Create or update a lead

Create a lead, or when a LinkedIn or Instagram identity already belongs to one, patch the fields sent onto it. Returns created or matched with the lead. Same identity formats as needleCreateLead.

TOOLneedleUpsertLead

Input

identitiesrequired

object

linkedinoptional

string

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.

instagramoptional

string

Username (john-doe), handle (@john-doe), or profile URL (https://www.instagram.com/john-doe). Stored as the username without @.

timezonerequired

string

firstNameoptional

string

lastNameoptional

string

companyNameoptional

string

companyDomainoptional

string

jobTitleoptional

string

emailoptional

string

imageUrloptional

string

propertiesoptional

object

Search docs

Search documentation, API reference, and MCP tools

We use cookies to enhance your experience on Needle and keep your data secure. Privacy Policy