Send Open InMail or SN InMail

Use the endpoint that creates a new conversation to send InMail through the Classic ans SN Inboxes.

Classic LinkedIn

Create a new LinkedIn conversation

  • Precondition

    • Your LinkedIn account must already be connected.

    • You should not be connected with recipient

    • You should have no another conversations created by open inmail with this recipient

    • Include the X-AccountId header in the request.

    • You must provide the profileId of the profile you want to Open InMail.

    • Profile must be "canSendClassicInmail": true (to check this use Retrieve LinkedIn Profile)

Field Type Required Description
profileId string ✅ The LinkedIn profile ID of the recipient.
message string ✅ The message body you want to send.
subject string ✅ Subject line of the InMail.
inMail boolean ✅ Must be set to true to indicate it is an Open InMail message.

POST/api/v1/conversations

curl https://api.salesflow.io/public/v1/conversations \
  --request POST \
  --header 'X-AccountId: 1234567890' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer HGIXEol8tC722A0ljT8AXoL6OepO7cuvWEmH54hg' \
  --data '{
  "profileId": "target_profile_id",
  "message": "your_message",
  "subject": "your_subject",
  "inMail": true
}'

RESPONSE EXAMPLE:

{
  "conversationId": "abc123xyz",
  "messageId": "msg789",
  "createdAt": "2025-07-28T10:12:45.000Z"
}

Sales Navigator

You can send InMail to LinkedIn members using either:

  • Paid InMail credits (via Sales Navigator plan)

  • Free InMail (when the recipient has an Open Profile)

Check number of available InMail credits

GET/api/v1/sales-nav/conversations/inmail-credits

curl https://sandbox-api.salesflow.io/stg/public/api/v1/sales-nav/conversations/inmail-credits \
  --header 'X-AccountId: 1234567890' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

Response showing the number of available credits (they used when user wants to send a paid InMail)

{
  "value": 1
}

Send an InMail

if you want to send Free InMails, value should be "inmailRestriction": "NO_RESTRICTION"

POST/api/v1/sales-nav/conversations

curl https://sandbox-api.salesflow.io/stg/public/api/v1/sales-nav/conversations \
  --request POST \
  --header 'X-AccountId: 1234567890' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "profileId": null,
  "message": null,
  "subject": null,
  "authToken": null,
  "authType": null
}'
Field Required Type Description
profileId ✅ string | null LinkedIn profile ID of the recipient
message ✅ string | null The actual message text to send
subject ✅ string | null Required to identify that this is “InMail“
authToken string | null (Optional) Token used internally for advanced auth flows (leave null)
authType string | null (Optional) Auth type metadata (leave null unless instructed)

Response:

{
  "messageId": null,
  "threadId": null
}