Needle LogoNeedle

LinkedIn

Send a Sales Navigator InMail

Sends an InMail. Does not require a connection. Reaches in-network recipients and out-of-network Open Profiles. Costs one credit unless LinkedIn treats the recipient as Open Profile, and requires a Sales Navigator seat on the connected account. Attach files with POST /api/v1/files first, then pass the returned url.

POST

/api/v1/linkedin/inmails

Request bodyrequired

connectedAccountIdrequired

string · uuid

Connected account to act as

identityrequired

string

User id (ACoAAA…) or public identifier.

subjectrequired

string

InMail subject line shown to the recipient.

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