Needle LogoNeedle

Leads

Update leads in bulk

Updates up to 500 existing leads by id; never creates one. Each row takes the same fields as PATCH /leads/{leadId}, and only the fields sent change. A row is skipped rather than failing the batch when the id does not name a lead in this workspace (lead_not_found), a handle cannot be read (invalid_identity), or a handle already belongs to another lead (identity_taken, with conflictingLeadId). Results come back in request order.

PATCH

/api/v1/leads/bulk

Request bodyrequired

leadsrequired

object[]

Response

200One result per submitted row, in request order.

results

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

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