Update a lead - Needle

PATCH

/api/v1/leads/{leadId}

Path parameters

leadId

required

string · uuid

Lead id

Request bodyrequired

identitiesoptional

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 @.

timezoneoptional

string

firstNameoptional

string

lastNameoptional

string

companyNameoptional

string

companyDomainoptional

string

jobTitleoptional

string

emailoptional

string

imageUrloptional

string

propertiesoptional

object

Response

200Updated lead.

lead

object

string · uuid

firstName

string | null

lastName

string | null

companyName

string | null

companyDomain

string | null

jobTitle

string | null

imageUrl

string | null

timezone

string

identities

object[]

liveEnrollment

object | null

campaignId	string · uuid
campaignName	string
status	"active" \| "waiting" \| "completed" \| "stopped" \| "failed"

createdAt

string · date-time

updatedAt

string · date-time

properties

object

enrollments

object[]

requestId

string · uuid

Id of this request, for support and troubleshooting

Errors

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

Path parameters

Request bodyrequired

Response

Errors

Search docs