Send LinkedIn InMail

curl --request POST \
  --url https://app.gtm-api.com/linkedin/v4/api/linkedin-messages/send-inmail \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Team-SID: <api-key>' \
  --data '
{
  "linkedin_account_sid": "<string>",
  "subject": "<string>",
  "text": "<string>",
  "ln_id": "<string>",
  "sn_id": "<string>",
  "attachments": [
    {
      "file_base64": "<string>",
      "file_url": "<string>",
      "file_name": "<string>",
      "file_type": "<string>",
      "file_byte_size": 2
    }
  ],
  "stop_if_replied_after": "2023-11-07T05:31:56Z",
  "client_reference": "<string>",
  "confirmed_not_sent": "<string>",
  "confirmed_sent": "<string>"
}
'

import requests

url = "https://app.gtm-api.com/linkedin/v4/api/linkedin-messages/send-inmail"

payload = {
    "linkedin_account_sid": "<string>",
    "subject": "<string>",
    "text": "<string>",
    "ln_id": "<string>",
    "sn_id": "<string>",
    "attachments": [
        {
            "file_base64": "<string>",
            "file_url": "<string>",
            "file_name": "<string>",
            "file_type": "<string>",
            "file_byte_size": 2
        }
    ],
    "stop_if_replied_after": "2023-11-07T05:31:56Z",
    "client_reference": "<string>",
    "confirmed_not_sent": "<string>",
    "confirmed_sent": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Team-SID": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    Authorization: 'Bearer <token>',
    'Team-SID': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    linkedin_account_sid: '<string>',
    subject: '<string>',
    text: '<string>',
    ln_id: '<string>',
    sn_id: '<string>',
    attachments: [
      {
        file_base64: '<string>',
        file_url: '<string>',
        file_name: '<string>',
        file_type: '<string>',
        file_byte_size: 2
      }
    ],
    stop_if_replied_after: '2023-11-07T05:31:56Z',
    client_reference: '<string>',
    confirmed_not_sent: '<string>',
    confirmed_sent: '<string>'
  })
};

fetch('https://app.gtm-api.com/linkedin/v4/api/linkedin-messages/send-inmail', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.gtm-api.com/linkedin/v4/api/linkedin-messages/send-inmail",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'linkedin_account_sid' => '<string>',
    'subject' => '<string>',
    'text' => '<string>',
    'ln_id' => '<string>',
    'sn_id' => '<string>',
    'attachments' => [
        [
                'file_base64' => '<string>',
                'file_url' => '<string>',
                'file_name' => '<string>',
                'file_type' => '<string>',
                'file_byte_size' => 2
        ]
    ],
    'stop_if_replied_after' => '2023-11-07T05:31:56Z',
    'client_reference' => '<string>',
    'confirmed_not_sent' => '<string>',
    'confirmed_sent' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "Team-SID: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.gtm-api.com/linkedin/v4/api/linkedin-messages/send-inmail"

	payload := strings.NewReader("{\n  \"linkedin_account_sid\": \"<string>\",\n  \"subject\": \"<string>\",\n  \"text\": \"<string>\",\n  \"ln_id\": \"<string>\",\n  \"sn_id\": \"<string>\",\n  \"attachments\": [\n    {\n      \"file_base64\": \"<string>\",\n      \"file_url\": \"<string>\",\n      \"file_name\": \"<string>\",\n      \"file_type\": \"<string>\",\n      \"file_byte_size\": 2\n    }\n  ],\n  \"stop_if_replied_after\": \"2023-11-07T05:31:56Z\",\n  \"client_reference\": \"<string>\",\n  \"confirmed_not_sent\": \"<string>\",\n  \"confirmed_sent\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Team-SID", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.gtm-api.com/linkedin/v4/api/linkedin-messages/send-inmail")
  .header("Authorization", "Bearer <token>")
  .header("Team-SID", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"linkedin_account_sid\": \"<string>\",\n  \"subject\": \"<string>\",\n  \"text\": \"<string>\",\n  \"ln_id\": \"<string>\",\n  \"sn_id\": \"<string>\",\n  \"attachments\": [\n    {\n      \"file_base64\": \"<string>\",\n      \"file_url\": \"<string>\",\n      \"file_name\": \"<string>\",\n      \"file_type\": \"<string>\",\n      \"file_byte_size\": 2\n    }\n  ],\n  \"stop_if_replied_after\": \"2023-11-07T05:31:56Z\",\n  \"client_reference\": \"<string>\",\n  \"confirmed_not_sent\": \"<string>\",\n  \"confirmed_sent\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.gtm-api.com/linkedin/v4/api/linkedin-messages/send-inmail")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Team-SID"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"linkedin_account_sid\": \"<string>\",\n  \"subject\": \"<string>\",\n  \"text\": \"<string>\",\n  \"ln_id\": \"<string>\",\n  \"sn_id\": \"<string>\",\n  \"attachments\": [\n    {\n      \"file_base64\": \"<string>\",\n      \"file_url\": \"<string>\",\n      \"file_name\": \"<string>\",\n      \"file_type\": \"<string>\",\n      \"file_byte_size\": 2\n    }\n  ],\n  \"stop_if_replied_after\": \"2023-11-07T05:31:56Z\",\n  \"client_reference\": \"<string>\",\n  \"confirmed_not_sent\": \"<string>\",\n  \"confirmed_sent\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "operation": "action",
  "action": "<string>",
  "item": {
    "sid": "<string>",
    "team_sid": "<string>",
    "linkedin_account_sid": "<string>",
    "linkedin_conversation_sid": "<string>",
    "messenger_type": "linkedin",
    "linkedin_type": "message",
    "type": "inbox",
    "automation": "auto",
    "ln_member_id": "<string>",
    "ln_id": "<string>",
    "sn_id": "<string>",
    "recruiter_id": "<string>",
    "nickname": "<string>",
    "subject": "<string>",
    "text": "<string>",
    "client_reference": "<string>",
    "attachments": [
      {
        "id": "<string>",
        "urn": "<string>",
        "name": "<string>",
        "content_type": "<string>",
        "content_url": "<string>",
        "file_byte_size": 123,
        "path": "<string>",
        "size": 123
      }
    ],
    "reactions": [
      {
        "emoji": "<string>",
        "count": 123,
        "is_viewer_reacted": true,
        "first_reacted_at": "<string>"
      }
    ],
    "is_deleted": true,
    "message_hash": "<string>",
    "sent_at": "<string>",
    "custom_content": {},
    "created_at": "<string>",
    "updated_at": "<string>",
    "deleted_at": "<string>"
  },
  "result": {},
  "meta": {
    "trace_id": "<string>",
    "span_id": "<string>",
    "timestamp": "<string>",
    "duration_ms": 1,
    "team_sid": "<string>",
    "actor_type": "<string>"
  },
  "pacing": {
    "linkedin_account_sid": "<string>",
    "limit_type": "<string>",
    "next_call_after": "<string>",
    "remaining_today": 1
  }
}

{
  "success": false,
  "error": {
    "code": "validation_failed",
    "message": "<string>",
    "recoverable": true,
    "suggestion": "<string>",
    "field_errors": {},
    "blockers": [
      {
        "type": "<string>",
        "severity": "hard",
        "description": "<string>",
        "entity_sid": "<string>",
        "resolution": "<string>",
        "resolution_hint": "<string>",
        "count": 123
      }
    ],
    "context": {}
  },
  "meta": {
    "trace_id": "<string>",
    "span_id": "<string>",
    "timestamp": "<string>",
    "duration_ms": 1,
    "team_sid": "<string>",
    "actor_type": "<string>"
  }
}

{
  "success": false,
  "error": {
    "code": "validation_failed",
    "message": "<string>",
    "recoverable": true,
    "suggestion": "<string>",
    "field_errors": {},
    "blockers": [
      {
        "type": "<string>",
        "severity": "hard",
        "description": "<string>",
        "entity_sid": "<string>",
        "resolution": "<string>",
        "resolution_hint": "<string>",
        "count": 123
      }
    ],
    "context": {}
  },
  "meta": {
    "trace_id": "<string>",
    "span_id": "<string>",
    "timestamp": "<string>",
    "duration_ms": 1,
    "team_sid": "<string>",
    "actor_type": "<string>"
  }
}

linkedin_messages

Send LinkedIn InMail

Send one premium InMail to a person (outward action). Person-addressed only via ln_id / sn_id, subject required (≤ 200), body ≤ 1900. Sends once per client_reference and person: a repeat is answered, never sent twice; on a 409 read error.context.send_outcome, never resend under a new key. Guards: send_inmails daily cap, Premium guard, InMail-credits guard (422 no_inmail_credits when the account’s pool is known empty: the seat’s grant inmail_credits with a Sales Navigator seat, premium_inmail_credits without; a balance never read does not block). Fire-on-success; the plugin’s inmail_credits_remaining is written back onto that pool, and LinkedIn’s own NOT_ENOUGH_INMAIL_CREDIT answers 422 no_inmail_credits and zeroes it (it is not a block of the target). When NOT: 1st-degree connection → send_linkedin_message (free); no Premium / zero credits → the guards 422; SN thread continuation → send_linkedin_sales_nav_message.

Contract:

MCP tool send_linkedin_inmail, registry package mcp.linkedin/linkedin_messages, mount linkedin.messaging.
Operation action, response envelope action.
Flags: dangerous: the MCP layer gates it behind a preview/commit token, and the effect cannot be undone through this API; paced: a call spends the send_inmails smart-limit bucket of the account it runs on, and calls of one bucket are spaced per account. A short wait is slept by the server; a longer one answers 429 rate_limited with context.retry_after, and the same call succeeds from that moment. Parallel calls on one account queue behind each other.

POST

api

linkedin-messages

send-inmail

Send LinkedIn InMail

curl --request POST \
  --url https://app.gtm-api.com/linkedin/v4/api/linkedin-messages/send-inmail \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Team-SID: <api-key>' \
  --data '
{
  "linkedin_account_sid": "<string>",
  "subject": "<string>",
  "text": "<string>",
  "ln_id": "<string>",
  "sn_id": "<string>",
  "attachments": [
    {
      "file_base64": "<string>",
      "file_url": "<string>",
      "file_name": "<string>",
      "file_type": "<string>",
      "file_byte_size": 2
    }
  ],
  "stop_if_replied_after": "2023-11-07T05:31:56Z",
  "client_reference": "<string>",
  "confirmed_not_sent": "<string>",
  "confirmed_sent": "<string>"
}
'

import requests

url = "https://app.gtm-api.com/linkedin/v4/api/linkedin-messages/send-inmail"

payload = {
    "linkedin_account_sid": "<string>",
    "subject": "<string>",
    "text": "<string>",
    "ln_id": "<string>",
    "sn_id": "<string>",
    "attachments": [
        {
            "file_base64": "<string>",
            "file_url": "<string>",
            "file_name": "<string>",
            "file_type": "<string>",
            "file_byte_size": 2
        }
    ],
    "stop_if_replied_after": "2023-11-07T05:31:56Z",
    "client_reference": "<string>",
    "confirmed_not_sent": "<string>",
    "confirmed_sent": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Team-SID": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    Authorization: 'Bearer <token>',
    'Team-SID': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    linkedin_account_sid: '<string>',
    subject: '<string>',
    text: '<string>',
    ln_id: '<string>',
    sn_id: '<string>',
    attachments: [
      {
        file_base64: '<string>',
        file_url: '<string>',
        file_name: '<string>',
        file_type: '<string>',
        file_byte_size: 2
      }
    ],
    stop_if_replied_after: '2023-11-07T05:31:56Z',
    client_reference: '<string>',
    confirmed_not_sent: '<string>',
    confirmed_sent: '<string>'
  })
};

fetch('https://app.gtm-api.com/linkedin/v4/api/linkedin-messages/send-inmail', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.gtm-api.com/linkedin/v4/api/linkedin-messages/send-inmail",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'linkedin_account_sid' => '<string>',
    'subject' => '<string>',
    'text' => '<string>',
    'ln_id' => '<string>',
    'sn_id' => '<string>',
    'attachments' => [
        [
                'file_base64' => '<string>',
                'file_url' => '<string>',
                'file_name' => '<string>',
                'file_type' => '<string>',
                'file_byte_size' => 2
        ]
    ],
    'stop_if_replied_after' => '2023-11-07T05:31:56Z',
    'client_reference' => '<string>',
    'confirmed_not_sent' => '<string>',
    'confirmed_sent' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "Team-SID: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.gtm-api.com/linkedin/v4/api/linkedin-messages/send-inmail"

	payload := strings.NewReader("{\n  \"linkedin_account_sid\": \"<string>\",\n  \"subject\": \"<string>\",\n  \"text\": \"<string>\",\n  \"ln_id\": \"<string>\",\n  \"sn_id\": \"<string>\",\n  \"attachments\": [\n    {\n      \"file_base64\": \"<string>\",\n      \"file_url\": \"<string>\",\n      \"file_name\": \"<string>\",\n      \"file_type\": \"<string>\",\n      \"file_byte_size\": 2\n    }\n  ],\n  \"stop_if_replied_after\": \"2023-11-07T05:31:56Z\",\n  \"client_reference\": \"<string>\",\n  \"confirmed_not_sent\": \"<string>\",\n  \"confirmed_sent\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Team-SID", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.gtm-api.com/linkedin/v4/api/linkedin-messages/send-inmail")
  .header("Authorization", "Bearer <token>")
  .header("Team-SID", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"linkedin_account_sid\": \"<string>\",\n  \"subject\": \"<string>\",\n  \"text\": \"<string>\",\n  \"ln_id\": \"<string>\",\n  \"sn_id\": \"<string>\",\n  \"attachments\": [\n    {\n      \"file_base64\": \"<string>\",\n      \"file_url\": \"<string>\",\n      \"file_name\": \"<string>\",\n      \"file_type\": \"<string>\",\n      \"file_byte_size\": 2\n    }\n  ],\n  \"stop_if_replied_after\": \"2023-11-07T05:31:56Z\",\n  \"client_reference\": \"<string>\",\n  \"confirmed_not_sent\": \"<string>\",\n  \"confirmed_sent\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.gtm-api.com/linkedin/v4/api/linkedin-messages/send-inmail")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Team-SID"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"linkedin_account_sid\": \"<string>\",\n  \"subject\": \"<string>\",\n  \"text\": \"<string>\",\n  \"ln_id\": \"<string>\",\n  \"sn_id\": \"<string>\",\n  \"attachments\": [\n    {\n      \"file_base64\": \"<string>\",\n      \"file_url\": \"<string>\",\n      \"file_name\": \"<string>\",\n      \"file_type\": \"<string>\",\n      \"file_byte_size\": 2\n    }\n  ],\n  \"stop_if_replied_after\": \"2023-11-07T05:31:56Z\",\n  \"client_reference\": \"<string>\",\n  \"confirmed_not_sent\": \"<string>\",\n  \"confirmed_sent\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "operation": "action",
  "action": "<string>",
  "item": {
    "sid": "<string>",
    "team_sid": "<string>",
    "linkedin_account_sid": "<string>",
    "linkedin_conversation_sid": "<string>",
    "messenger_type": "linkedin",
    "linkedin_type": "message",
    "type": "inbox",
    "automation": "auto",
    "ln_member_id": "<string>",
    "ln_id": "<string>",
    "sn_id": "<string>",
    "recruiter_id": "<string>",
    "nickname": "<string>",
    "subject": "<string>",
    "text": "<string>",
    "client_reference": "<string>",
    "attachments": [
      {
        "id": "<string>",
        "urn": "<string>",
        "name": "<string>",
        "content_type": "<string>",
        "content_url": "<string>",
        "file_byte_size": 123,
        "path": "<string>",
        "size": 123
      }
    ],
    "reactions": [
      {
        "emoji": "<string>",
        "count": 123,
        "is_viewer_reacted": true,
        "first_reacted_at": "<string>"
      }
    ],
    "is_deleted": true,
    "message_hash": "<string>",
    "sent_at": "<string>",
    "custom_content": {},
    "created_at": "<string>",
    "updated_at": "<string>",
    "deleted_at": "<string>"
  },
  "result": {},
  "meta": {
    "trace_id": "<string>",
    "span_id": "<string>",
    "timestamp": "<string>",
    "duration_ms": 1,
    "team_sid": "<string>",
    "actor_type": "<string>"
  },
  "pacing": {
    "linkedin_account_sid": "<string>",
    "limit_type": "<string>",
    "next_call_after": "<string>",
    "remaining_today": 1
  }
}

{
  "success": false,
  "error": {
    "code": "validation_failed",
    "message": "<string>",
    "recoverable": true,
    "suggestion": "<string>",
    "field_errors": {},
    "blockers": [
      {
        "type": "<string>",
        "severity": "hard",
        "description": "<string>",
        "entity_sid": "<string>",
        "resolution": "<string>",
        "resolution_hint": "<string>",
        "count": 123
      }
    ],
    "context": {}
  },
  "meta": {
    "trace_id": "<string>",
    "span_id": "<string>",
    "timestamp": "<string>",
    "duration_ms": 1,
    "team_sid": "<string>",
    "actor_type": "<string>"
  }
}

{
  "success": false,
  "error": {
    "code": "validation_failed",
    "message": "<string>",
    "recoverable": true,
    "suggestion": "<string>",
    "field_errors": {},
    "blockers": [
      {
        "type": "<string>",
        "severity": "hard",
        "description": "<string>",
        "entity_sid": "<string>",
        "resolution": "<string>",
        "resolution_hint": "<string>",
        "count": 123
      }
    ],
    "context": {}
  },
  "meta": {
    "trace_id": "<string>",
    "span_id": "<string>",
    "timestamp": "<string>",
    "duration_ms": 1,
    "team_sid": "<string>",
    "actor_type": "<string>"
  }
}

Authorizations

Authorization

string

header

required

Access token issued by gtm.service.id. Its access_identity claim carries team_sid, actor_sid and actor_type, and that team scope is authoritative.

Team-SID

string

header

required

Team scope for tokens that do not carry one. Ignored when the token already names a team.

Body

application/json

Request body of send_linkedin_inmail.

linkedin_account_sid

string

required

LinkedIn account sid (ln_ac_…).

Required string length: 18

Pattern: ^ln_ac_

subject

string

required

REQUIRED InMail subject; 1..200 chars.

Required string length: 1 - 200

text

string

required

InMail body; 1..1900 chars. Sent verbatim: the platform renders no merge fields, a {{first_name}} goes out as those braces.

Required string length: 1 - 1900

ln_id

string | null

Regular-profile URN (ACoAA…); one URN required.

Maximum string length: 128

sn_id

string | null

Sales Navigator URN; interchangeable with ln_id.

Maximum string length: 64

attachments

object[]

Exactly one of file_base64 / file_url per item; 35 MB decoded total per send. An item whose file_type is video/* is delivered as a playable video in the thread; any other type arrives as a generic file attachment.

Show child attributes

stop_if_replied_after

string<date-time> | null

ISO 8601 UTC moment. When given, the thread is read from LinkedIn before the send and the send is refused with 409 replied if the person wrote after this moment (context.linkedin_message_sid names their message: read it before you send again); 503 reply_check_unavailable when that read fails, nothing sent, retry after retry_after. Omit or null to send regardless.

client_reference

string | null

Your key for this ONE message (max 255, byte for byte): one key per message, the same key on every repeat of it. The key and its place (the thread, else the person) are one message whatever it says, and a repeat never goes out twice: it answers 200 with the row the first send stored (result.idempotent_replay, result.content_differs when this request says something else) or 409 naming error.context.send_outcome (in_flight, unknown with retry_after and send_decisive_at, or sent; not_sent with blocking_activity_log_sid when another message holds the place). The same key at another place is another message. Without a key the same words to the same place count as a repeat for an hour after they went out. Stored on the row and searchable; check_linkedin_message_sent asks by it.

Maximum string length: 255

confirmed_not_sent

string | null

A person's word that an earlier attempt of THIS message is not on LinkedIn: its activity_log_sid (ln_al_...), from the 409 or check_linkedin_message_sent, given only after someone looked at the conversation. Taken once the attempt can no longer land (before that: 409 send_outcome_unknown, waiting_for may_still_land, retry_after and send_decisive_at that moment): it settles that attempt not_sent and this request goes out. Moot when the attempt is no longer in doubt; another message's sid is 422 not_this_message.

Required string length: 18

Pattern: ^ln_al_

confirmed_sent

string | null

A person's word that an earlier attempt of THIS message IS on LinkedIn: its activity_log_sid, as for confirmed_not_sent (never both). Taken at once; it settles the attempt sent and sends nothing: the answer is 409 concurrent_send_in_flight with send_outcome sent, or 200 with the row once it is stored. Another message's sid is 422 not_this_message; an attempt already proved not sent is 409 confirmed_sent_contradicts.

Required string length: 18

Pattern: ^ln_al_

Response

action success envelope.

success

enum<boolean>

required

Available options:

true

operation

enum<string>

required

Available options:

action

action

string

required

kebab-case verb; matches the route segment.

item

object | null

required

Show child attributes

result

object

required

Show child attributes

Overview

LinkedIn API

ID and Teams API

Orchestration API

Send LinkedIn InMail

Authorizations

Body

Response