LinkedIn

Send a LinkedIn message

Sends a direct message. Only first-degree connections can receive one, so check isConnected on the profile first and send an InMail otherwise. Open Profile (isOpenProfile) can receive InMail without a connection. Attach files with POST /api/v1/files first, then pass the returned url.

POST

/api/v1/linkedin/messages

Request bodyrequired

connectedAccountIdrequired

string · uuid

Connected account to act as

identityrequired

string

User id (ACoAAA…) or public identifier.

textrequired

string

attachmentsoptional

object[]

Files from POST /api/v1/files. Pass the returned url, not a signed URL. Needle reads the private object and sends the bytes to LinkedIn.

Response

201Send result.

result

object

messageId

string | null

conversationId

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