Needle LogoNeedle

LinkedIn

Send a connection invitation

Sends a connection invitation with an optional note of up to 300 characters. Fails if the recipient is already connected or has an invitation pending.

POST

/api/v1/linkedin/invitations

Request bodyrequired

connectedAccountIdrequired

string · uuid

Connected account to act as

identityrequired

string

User id (ACoAAA…) or public identifier.

noteoptional

string

Response

201Invitation result.

result

object

invitationId

string | null

sentAt

string · date-time

remainingUsage

object

Remaining allowance for this action on the connected account across hourly, daily, and weekly windows. Each action type has its own limits.

hour

integer | null

Remaining hourly allowance for this action. Null when this action has no hourly cap.

day

integer

Remaining daily allowance for this action.

week

integer | null

Remaining weekly allowance for this action. Null when this action has no weekly cap.

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