curl --request GET \
--url https://app.gtm-api.com/linkedin/v4/api/linkedin-accounts/{sid} \
--header 'Authorization: Bearer <token>' \
--header 'Team-SID: <api-key>'import requests
url = "https://app.gtm-api.com/linkedin/v4/api/linkedin-accounts/{sid}"
headers = {
"Authorization": "Bearer <token>",
"Team-SID": "<api-key>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {Authorization: 'Bearer <token>', 'Team-SID': '<api-key>'}
};
fetch('https://app.gtm-api.com/linkedin/v4/api/linkedin-accounts/{sid}', 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-accounts/{sid}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"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"
"net/http"
"io"
)
func main() {
url := "https://app.gtm-api.com/linkedin/v4/api/linkedin-accounts/{sid}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Team-SID", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://app.gtm-api.com/linkedin/v4/api/linkedin-accounts/{sid}")
.header("Authorization", "Bearer <token>")
.header("Team-SID", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.gtm-api.com/linkedin/v4/api/linkedin-accounts/{sid}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
request["Team-SID"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"success": true,
"operation": "get",
"item": {
"sid": "<string>",
"team_sid": "<string>",
"antidetect_browser_sid": "<string>",
"status": "new",
"account_share_sid": "<string>",
"share_role": "owner",
"ln_id": "<string>",
"ln_member_id": "<string>",
"sn_id": "<string>",
"nickname": "<string>",
"recruiter_seat_id": "<string>",
"recruiter_contract_id": "<string>",
"recruiter_session_expires_at": "<string>",
"full_name": "<string>",
"avatar_url": "<string>",
"label": "<string>",
"has_premium": true,
"has_sn": true,
"recruiter_status": "active",
"smart_limits_enabled": true,
"inmail_credits": 123,
"premium_inmail_credits": 123,
"recruiter_inmail_credits": 123,
"last_premium_check_at": "<string>",
"last_connections_sync_at": "<string>",
"last_conversations_sync_at": "<string>",
"last_sales_navigator_conversations_sync_at": "<string>",
"last_recruiter_conversations_sync_at": "<string>",
"last_connection_requests_sync_at": "<string>",
"last_connection_invitations_sync_at": "<string>",
"last_followers_sync_at": "<string>",
"last_snapshot_at": "<string>",
"initial_sync_completed_at": "<string>",
"initial_sync_held_at": "<string>",
"initial_sync_hold_reason": "<string>",
"last_heartbeat_at": "<string>",
"sync_config": {
"entries": {
"connections": {
"interval_minutes": 123
},
"conversations": {
"interval_minutes": 123
},
"sales_navigator_conversations": {
"interval_minutes": 123
},
"recruiter_conversations": {
"interval_minutes": 123
},
"connection_requests": {
"interval_minutes": 123
},
"connection_invitations": {
"interval_minutes": 123
},
"premium_check": {
"interval_minutes": 123
},
"snapshot_check": {
"interval_minutes": 123
},
"followers": {
"interval_minutes": 123
}
},
"timezone": "<string>",
"window": [
{
"day_of_week": 4,
"start_minute": 719,
"end_minute": 720
}
]
},
"webhook_config": {
"connections": {
"enabled": true,
"since": "<string>"
},
"connection_requests": {
"enabled": true,
"since": "<string>"
},
"connection_invitations": {
"enabled": true,
"since": "<string>"
},
"conversations": {
"enabled": true,
"since": "<string>"
},
"sales_navigator_conversations": {
"enabled": true,
"since": "<string>"
},
"recruiter_conversations": {
"enabled": true,
"since": "<string>"
},
"messages": {
"enabled": true,
"since": "<string>"
},
"followers": {
"enabled": true,
"since": "<string>"
},
"snapshot": {
"enabled": true,
"since": "<string>"
},
"strike_log": {
"enabled": true,
"since": "<string>"
},
"limits": {
"enabled": true,
"since": "<string>"
}
},
"created_by": {
"actor_type": "user",
"actor_sid": "<string>",
"team_sid": "<string>",
"permissions": {},
"reason": "<string>",
"request_sid": "<string>"
},
"created_at": "<string>",
"updated_at": "<string>",
"deleted_at": "<string>"
},
"included": {},
"includes": [
"<string>"
],
"meta": {
"trace_id": "<string>",
"span_id": "<string>",
"timestamp": "<string>",
"duration_ms": 1,
"team_sid": "<string>",
"actor_type": "<string>"
}
}Get LinkedIn account
Fetch a single LinkedIn account by sid, with optional eager-loaded relations. For login or health state add include antidetect_browser: browser status login_issue means the sender is signed out of LinkedIn, while the item status field is platform lifecycle, not login state. While the first sync of the account runs (initial_sync_completed_at null) include initial_sync says what it is doing and about when it is through; outbound verbs wait and the limits are set when it is done.
Contract:
- MCP tool
get_linkedin_account, registry packagemcp.linkedin/linkedin_accounts, mountlinkedin.accounts. - Operation
get, response envelopeget. - Flags: read only.
curl --request GET \
--url https://app.gtm-api.com/linkedin/v4/api/linkedin-accounts/{sid} \
--header 'Authorization: Bearer <token>' \
--header 'Team-SID: <api-key>'import requests
url = "https://app.gtm-api.com/linkedin/v4/api/linkedin-accounts/{sid}"
headers = {
"Authorization": "Bearer <token>",
"Team-SID": "<api-key>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {Authorization: 'Bearer <token>', 'Team-SID': '<api-key>'}
};
fetch('https://app.gtm-api.com/linkedin/v4/api/linkedin-accounts/{sid}', 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-accounts/{sid}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"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"
"net/http"
"io"
)
func main() {
url := "https://app.gtm-api.com/linkedin/v4/api/linkedin-accounts/{sid}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Team-SID", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://app.gtm-api.com/linkedin/v4/api/linkedin-accounts/{sid}")
.header("Authorization", "Bearer <token>")
.header("Team-SID", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.gtm-api.com/linkedin/v4/api/linkedin-accounts/{sid}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
request["Team-SID"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"success": true,
"operation": "get",
"item": {
"sid": "<string>",
"team_sid": "<string>",
"antidetect_browser_sid": "<string>",
"status": "new",
"account_share_sid": "<string>",
"share_role": "owner",
"ln_id": "<string>",
"ln_member_id": "<string>",
"sn_id": "<string>",
"nickname": "<string>",
"recruiter_seat_id": "<string>",
"recruiter_contract_id": "<string>",
"recruiter_session_expires_at": "<string>",
"full_name": "<string>",
"avatar_url": "<string>",
"label": "<string>",
"has_premium": true,
"has_sn": true,
"recruiter_status": "active",
"smart_limits_enabled": true,
"inmail_credits": 123,
"premium_inmail_credits": 123,
"recruiter_inmail_credits": 123,
"last_premium_check_at": "<string>",
"last_connections_sync_at": "<string>",
"last_conversations_sync_at": "<string>",
"last_sales_navigator_conversations_sync_at": "<string>",
"last_recruiter_conversations_sync_at": "<string>",
"last_connection_requests_sync_at": "<string>",
"last_connection_invitations_sync_at": "<string>",
"last_followers_sync_at": "<string>",
"last_snapshot_at": "<string>",
"initial_sync_completed_at": "<string>",
"initial_sync_held_at": "<string>",
"initial_sync_hold_reason": "<string>",
"last_heartbeat_at": "<string>",
"sync_config": {
"entries": {
"connections": {
"interval_minutes": 123
},
"conversations": {
"interval_minutes": 123
},
"sales_navigator_conversations": {
"interval_minutes": 123
},
"recruiter_conversations": {
"interval_minutes": 123
},
"connection_requests": {
"interval_minutes": 123
},
"connection_invitations": {
"interval_minutes": 123
},
"premium_check": {
"interval_minutes": 123
},
"snapshot_check": {
"interval_minutes": 123
},
"followers": {
"interval_minutes": 123
}
},
"timezone": "<string>",
"window": [
{
"day_of_week": 4,
"start_minute": 719,
"end_minute": 720
}
]
},
"webhook_config": {
"connections": {
"enabled": true,
"since": "<string>"
},
"connection_requests": {
"enabled": true,
"since": "<string>"
},
"connection_invitations": {
"enabled": true,
"since": "<string>"
},
"conversations": {
"enabled": true,
"since": "<string>"
},
"sales_navigator_conversations": {
"enabled": true,
"since": "<string>"
},
"recruiter_conversations": {
"enabled": true,
"since": "<string>"
},
"messages": {
"enabled": true,
"since": "<string>"
},
"followers": {
"enabled": true,
"since": "<string>"
},
"snapshot": {
"enabled": true,
"since": "<string>"
},
"strike_log": {
"enabled": true,
"since": "<string>"
},
"limits": {
"enabled": true,
"since": "<string>"
}
},
"created_by": {
"actor_type": "user",
"actor_sid": "<string>",
"team_sid": "<string>",
"permissions": {},
"reason": "<string>",
"request_sid": "<string>"
},
"created_at": "<string>",
"updated_at": "<string>",
"deleted_at": "<string>"
},
"included": {},
"includes": [
"<string>"
],
"meta": {
"trace_id": "<string>",
"span_id": "<string>",
"timestamp": "<string>",
"duration_ms": 1,
"team_sid": "<string>",
"actor_type": "<string>"
}
}Authorizations
Query Parameters
Query parameter include.
antidetect_browser carries the sender LOGIN and runtime state (browser status login_issue means signed out of LinkedIn, restricted means signed out and the public profile is gone, a LinkedIn restriction; also error_reason, logout_count, last_logout_at). The account item alone cannot answer "is this sender signed in": its status field is lifecycle. Health data: linkedin_account_smart_limits (budgets and holds), linkedin_account_snapshot (latest warmup score), linkedin_account_quota_hits / linkedin_account_block_log (last 50 incident rows each), *_counts (child tallies). initial_sync is the first sync of a new account, null once it is done: state (syncing | waiting_for_reads = the day's reads are used and it goes on by itself at resumes_at | waiting_for_browser = start the browser or sign in again), conversations_synced, estimated_completion_at and estimated_days_left (0 = today; both null in the first minutes and while the browser is down). A large account takes days on purpose: reading it in one go is not safe, so the platform paces it. Until it is done outbound verbs wait and the limits are provisional, set when it finishes. Say that, not that something is stuck.
antidetect_browser, linkedin_account_smart_limits, linkedin_account_snapshot, linkedin_account_quota_hits, linkedin_account_block_log, linkedin_account_block_log_counts, linkedin_connections_counts, linkedin_connection_requests_counts, linkedin_connection_invitations_counts, linkedin_conversations_counts, linkedin_followers_counts, initial_sync