curl --request POST \
--url https://app.gtm-api.com/linkedin/v4/api/linkedin-connection-requests/send \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Team-SID: <api-key>' \
--data '
{
"linkedin_account_sid": "<string>",
"profile_id": "<string>",
"public_identifier": "<string>",
"ln_member_id": "<string>",
"recruiter_id": "<string>",
"note": "<string>",
"allow_no_note_fallback": true,
"client_reference": "<string>",
"confirmed_not_sent": "<string>",
"confirmed_sent": "<string>"
}
'import requests
url = "https://app.gtm-api.com/linkedin/v4/api/linkedin-connection-requests/send"
payload = {
"linkedin_account_sid": "<string>",
"profile_id": "<string>",
"public_identifier": "<string>",
"ln_member_id": "<string>",
"recruiter_id": "<string>",
"note": "<string>",
"allow_no_note_fallback": True,
"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>',
profile_id: '<string>',
public_identifier: '<string>',
ln_member_id: '<string>',
recruiter_id: '<string>',
note: '<string>',
allow_no_note_fallback: true,
client_reference: '<string>',
confirmed_not_sent: '<string>',
confirmed_sent: '<string>'
})
};
fetch('https://app.gtm-api.com/linkedin/v4/api/linkedin-connection-requests/send', 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-connection-requests/send",
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>',
'profile_id' => '<string>',
'public_identifier' => '<string>',
'ln_member_id' => '<string>',
'recruiter_id' => '<string>',
'note' => '<string>',
'allow_no_note_fallback' => true,
'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-connection-requests/send"
payload := strings.NewReader("{\n \"linkedin_account_sid\": \"<string>\",\n \"profile_id\": \"<string>\",\n \"public_identifier\": \"<string>\",\n \"ln_member_id\": \"<string>\",\n \"recruiter_id\": \"<string>\",\n \"note\": \"<string>\",\n \"allow_no_note_fallback\": true,\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-connection-requests/send")
.header("Authorization", "Bearer <token>")
.header("Team-SID", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"linkedin_account_sid\": \"<string>\",\n \"profile_id\": \"<string>\",\n \"public_identifier\": \"<string>\",\n \"ln_member_id\": \"<string>\",\n \"recruiter_id\": \"<string>\",\n \"note\": \"<string>\",\n \"allow_no_note_fallback\": true,\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-connection-requests/send")
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 \"profile_id\": \"<string>\",\n \"public_identifier\": \"<string>\",\n \"ln_member_id\": \"<string>\",\n \"recruiter_id\": \"<string>\",\n \"note\": \"<string>\",\n \"allow_no_note_fallback\": true,\n \"client_reference\": \"<string>\",\n \"confirmed_not_sent\": \"<string>\",\n \"confirmed_sent\": \"<string>\"\n}"
response = http.request(request)
puts response.read_bodySend connection request
Send one outbound LinkedIn connection request. Address the person by profile_id (ln_id or sn_id URN) or public_identifier (slug or /in/ URL). Checks: daily limit, note cap (200 free / 300 premium), 21-day resend cooldown. A row only when LinkedIn confirms. 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. A request on record under another key or none: 422 resend_not_available, context.cause pending, accepted, cooldown (resend_available_at), sync_reset, or linkedin (LinkedIn alone holds the earlier one: sync, retry weeks later); an accepted one is probed on LinkedIn first (context.probe) and a removed connection is invited again. 422 target_blocked: they blocked the account (context.block_log_sid; never retry). 422 target_unavailable: nobody in the team can see their account (retry after context.retry_after). check_linkedin_connection_request_sent asks what an invitation came to without sending.
Contract:
- MCP tool
send_linkedin_connection_request, registry packagemcp.linkedin/linkedin_connection_requests, mountlinkedin.network. - Operation
action, response envelopeaction. - Flags: dangerous: the MCP layer gates it behind a preview/commit token, and the effect cannot be undone through this API; step eligible: gtm.service.orchestration can run this verb as a mass-action plan step, once per item; paced: a call spends the
send_connection_requestssmart-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 429rate_limitedwithcontext.retry_after, and the same call succeeds from that moment. Parallel calls on one account queue behind each other.
curl --request POST \
--url https://app.gtm-api.com/linkedin/v4/api/linkedin-connection-requests/send \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Team-SID: <api-key>' \
--data '
{
"linkedin_account_sid": "<string>",
"profile_id": "<string>",
"public_identifier": "<string>",
"ln_member_id": "<string>",
"recruiter_id": "<string>",
"note": "<string>",
"allow_no_note_fallback": true,
"client_reference": "<string>",
"confirmed_not_sent": "<string>",
"confirmed_sent": "<string>"
}
'import requests
url = "https://app.gtm-api.com/linkedin/v4/api/linkedin-connection-requests/send"
payload = {
"linkedin_account_sid": "<string>",
"profile_id": "<string>",
"public_identifier": "<string>",
"ln_member_id": "<string>",
"recruiter_id": "<string>",
"note": "<string>",
"allow_no_note_fallback": True,
"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>',
profile_id: '<string>',
public_identifier: '<string>',
ln_member_id: '<string>',
recruiter_id: '<string>',
note: '<string>',
allow_no_note_fallback: true,
client_reference: '<string>',
confirmed_not_sent: '<string>',
confirmed_sent: '<string>'
})
};
fetch('https://app.gtm-api.com/linkedin/v4/api/linkedin-connection-requests/send', 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-connection-requests/send",
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>',
'profile_id' => '<string>',
'public_identifier' => '<string>',
'ln_member_id' => '<string>',
'recruiter_id' => '<string>',
'note' => '<string>',
'allow_no_note_fallback' => true,
'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-connection-requests/send"
payload := strings.NewReader("{\n \"linkedin_account_sid\": \"<string>\",\n \"profile_id\": \"<string>\",\n \"public_identifier\": \"<string>\",\n \"ln_member_id\": \"<string>\",\n \"recruiter_id\": \"<string>\",\n \"note\": \"<string>\",\n \"allow_no_note_fallback\": true,\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-connection-requests/send")
.header("Authorization", "Bearer <token>")
.header("Team-SID", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"linkedin_account_sid\": \"<string>\",\n \"profile_id\": \"<string>\",\n \"public_identifier\": \"<string>\",\n \"ln_member_id\": \"<string>\",\n \"recruiter_id\": \"<string>\",\n \"note\": \"<string>\",\n \"allow_no_note_fallback\": true,\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-connection-requests/send")
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 \"profile_id\": \"<string>\",\n \"public_identifier\": \"<string>\",\n \"ln_member_id\": \"<string>\",\n \"recruiter_id\": \"<string>\",\n \"note\": \"<string>\",\n \"allow_no_note_fallback\": true,\n \"client_reference\": \"<string>\",\n \"confirmed_not_sent\": \"<string>\",\n \"confirmed_sent\": \"<string>\"\n}"
response = http.request(request)
puts response.read_bodyAuthorizations
Body
Request body of send_linkedin_connection_request.
The same field under the slug's name: a vanity slug (jane-doe), a linkedin.com/in/ link (a signup, a CRM), or a URN. Resolved server-side to the URN: the team's own rows first (connections, invitations, followers, the data request journal), then the stored corpus, then ONE lite-profile read on the sender (self_account_sync, never the invitation bucket; keyed by your client_reference and the person, so one reference serves many people). result.target_resolved_via says which; a slug LinkedIn does not know is 422 public_identifier_unresolved. Exactly one of the four person keys.
2048Default false. When the note is longer than the sender's cap (200 free / 300 premium), send the invite WITHOUT it instead of refusing 422, for campaigns where reaching the person beats personalizing. The response says which happened in result.note_fallback_used, and the stored row carries note=null, so a follow-up does not assume a note the prospect never saw. Scope, stated plainly: this covers the length cap, which the server evaluates itself. LinkedIn's own monthly with-note quota is only visible at send time and arrives untyped, so a refusal there still fails the call rather than being retried blind (a retry after an ambiguous send can invite the person twice).
Your key for this ONE invitation (max 255, byte for byte): one key per invitation, the same key on every repeat of it. The key and the person (the member the URN decodes to) are one invitation whatever its note says, and a repeat never goes out twice: it answers 200 with the request the first send stored (result.idempotent_replay, result.content_differs when this note differs) 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 invitation to the person is on its way or in doubt). Without a key the same note to the same person counts as a repeat for an hour after it went out. Stored on the row and searchable; check_linkedin_connection_request_sent asks by it.
255A person's word that an earlier attempt of THIS invitation is not on LinkedIn: its activity_log_sid (ln_al_...), from the 409 or check_linkedin_connection_request_sent, given only after someone looked at the account's sent invitations. 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 invitation's sid is 422 not_this_message.
18^ln_al_A person's word that an earlier attempt of THIS invitation 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 request once it is stored. Another invitation's sid is 422 not_this_message; an attempt already proved not sent is 409 confirmed_sent_contradicts.
18^ln_al_Response
action success envelope.