Enrich person recommendations

curl --request POST \
  --url https://app.gtm-api.com/linkedin/v4/api/linkedin-enrichment/person-recommendations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Team-SID: <api-key>' \
  --data '
{
  "profile_id": "<string>",
  "public_identifier": "<string>",
  "linkedin_account_sid": "<string>",
  "idempotency_key": "<string>"
}
'

import requests

url = "https://app.gtm-api.com/linkedin/v4/api/linkedin-enrichment/person-recommendations"

payload = {
    "profile_id": "<string>",
    "public_identifier": "<string>",
    "linkedin_account_sid": "<string>",
    "idempotency_key": "<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({
    profile_id: '<string>',
    public_identifier: '<string>',
    linkedin_account_sid: '<string>',
    idempotency_key: '<string>'
  })
};

fetch('https://app.gtm-api.com/linkedin/v4/api/linkedin-enrichment/person-recommendations', 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-enrichment/person-recommendations",
  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([
    'profile_id' => '<string>',
    'public_identifier' => '<string>',
    'linkedin_account_sid' => '<string>',
    'idempotency_key' => '<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-enrichment/person-recommendations"

	payload := strings.NewReader("{\n  \"profile_id\": \"<string>\",\n  \"public_identifier\": \"<string>\",\n  \"linkedin_account_sid\": \"<string>\",\n  \"idempotency_key\": \"<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-enrichment/person-recommendations")
  .header("Authorization", "Bearer <token>")
  .header("Team-SID", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"profile_id\": \"<string>\",\n  \"public_identifier\": \"<string>\",\n  \"linkedin_account_sid\": \"<string>\",\n  \"idempotency_key\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.gtm-api.com/linkedin/v4/api/linkedin-enrichment/person-recommendations")

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  \"profile_id\": \"<string>\",\n  \"public_identifier\": \"<string>\",\n  \"linkedin_account_sid\": \"<string>\",\n  \"idempotency_key\": \"<string>\"\n}"

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

{
  "success": true,
  "operation": "action",
  "action": "<string>",
  "item": "<unknown>",
  "result": {
    "recommendations": [
      {
        "direction": "received",
        "counterpart": {
          "ln_member_id": "<string>",
          "ln_id": "<string>",
          "sn_id": "<string>",
          "nickname": "<string>",
          "full_name": "<string>",
          "headline": "<string>"
        },
        "relationship": "<string>",
        "text": "<string>",
        "created_at": "<string>"
      }
    ],
    "data_request": {}
  },
  "meta": {
    "trace_id": "<string>",
    "span_id": "<string>",
    "timestamp": "<string>",
    "duration_ms": 1,
    "debug_url": "<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,
    "debug_url": "<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,
    "debug_url": "<string>"
  }
}

linkedin_enrichment

Enrich person recommendations

Recommendations on the target profile: who vouches for them and in what words. direction picks received (the default, what LinkedIn opens on) or given; these are two SEPARATE reads of the same screen, so asking for both runs the method twice. cached 7d. The counterpart carries a nickname, name, headline and network distance but NO ln_id: LinkedIn does not put the member urn in this payload, so enrich the nickname separately if you need the urn. created_at is parsed out of the free-text context line and is null when that line has no date. Address by profile_id XOR public_identifier, the same exactly-one-of rule as every other person read: passing both is a 422, they prohibit each other. The screen behind this one is the exception that needs the vanity slug AND the member urn at once, so the backend resolves whichever half you did not send.

Contract:

MCP tool enrich_linkedin_person_recommendations, registry package mcp.linkedin/linkedin_enrichment, mount linkedin.enrichment.
Operation action, response envelope action.
Flags: none.

POST

api

linkedin-enrichment

person-recommendations

Enrich person recommendations

curl --request POST \
  --url https://app.gtm-api.com/linkedin/v4/api/linkedin-enrichment/person-recommendations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Team-SID: <api-key>' \
  --data '
{
  "profile_id": "<string>",
  "public_identifier": "<string>",
  "linkedin_account_sid": "<string>",
  "idempotency_key": "<string>"
}
'

import requests

url = "https://app.gtm-api.com/linkedin/v4/api/linkedin-enrichment/person-recommendations"

payload = {
    "profile_id": "<string>",
    "public_identifier": "<string>",
    "linkedin_account_sid": "<string>",
    "idempotency_key": "<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({
    profile_id: '<string>',
    public_identifier: '<string>',
    linkedin_account_sid: '<string>',
    idempotency_key: '<string>'
  })
};

fetch('https://app.gtm-api.com/linkedin/v4/api/linkedin-enrichment/person-recommendations', 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-enrichment/person-recommendations",
  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([
    'profile_id' => '<string>',
    'public_identifier' => '<string>',
    'linkedin_account_sid' => '<string>',
    'idempotency_key' => '<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-enrichment/person-recommendations"

	payload := strings.NewReader("{\n  \"profile_id\": \"<string>\",\n  \"public_identifier\": \"<string>\",\n  \"linkedin_account_sid\": \"<string>\",\n  \"idempotency_key\": \"<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-enrichment/person-recommendations")
  .header("Authorization", "Bearer <token>")
  .header("Team-SID", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"profile_id\": \"<string>\",\n  \"public_identifier\": \"<string>\",\n  \"linkedin_account_sid\": \"<string>\",\n  \"idempotency_key\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.gtm-api.com/linkedin/v4/api/linkedin-enrichment/person-recommendations")

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  \"profile_id\": \"<string>\",\n  \"public_identifier\": \"<string>\",\n  \"linkedin_account_sid\": \"<string>\",\n  \"idempotency_key\": \"<string>\"\n}"

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

{
  "success": true,
  "operation": "action",
  "action": "<string>",
  "item": "<unknown>",
  "result": {
    "recommendations": [
      {
        "direction": "received",
        "counterpart": {
          "ln_member_id": "<string>",
          "ln_id": "<string>",
          "sn_id": "<string>",
          "nickname": "<string>",
          "full_name": "<string>",
          "headline": "<string>"
        },
        "relationship": "<string>",
        "text": "<string>",
        "created_at": "<string>"
      }
    ],
    "data_request": {}
  },
  "meta": {
    "trace_id": "<string>",
    "span_id": "<string>",
    "timestamp": "<string>",
    "duration_ms": 1,
    "debug_url": "<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,
    "debug_url": "<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,
    "debug_url": "<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 enrich_linkedin_person_recommendations.

profile_id

string

ln_id (ACoAA…) or sn_id (ACwAA…), interchangeable for dispatch. Provide profile_id XOR public_identifier.

Maximum string length: 128

public_identifier

string

Vanity slug from /in/…, or the whole profile URL it comes from (any linkedin.com host, locale or mwlite prefix, query and trailing slash included): the URL is reduced to the slug before dispatch, and both forms share one ledger entry. A linkedin.com URL that is NOT a profile URL is refused 422 public_identifier_not_resolvable instead of being sent as a slug. Provide public_identifier XOR profile_id. On sub-record methods a slug-only call needs a stored URN (run person-lite-profile first) or is refused not_dispatchable.

Maximum string length: 2048

direction

enum<string> | null

received (default) = written ABOUT the target; given = written BY the target. Separate reads, so each spends the method.

Available options:

received,

given

linkedin_account_sid

string | null

Executor account (ln_ac_...). Given: the call runs on that account ONLY; a saturated or held enrichment bucket refuses 429 bucket_saturated (with retry_after). Omitted: the service auto-picks one of your connected accounts with remaining capacity (422 no_connected_accounts when none is ready, 429 when all are at capacity).

Required string length: 18

Pattern: ^ln_ac_

idempotency_key

string | null

Replay guard (team_sid, idempotency_key). A repeat with the same key returns the stored ledger outcome: no re-execution.

Maximum string length: 128

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

any

required

result

object

required

Show child attributes

Overview

LinkedIn API

ID and Teams API

Orchestration API

Enrich person recommendations

Authorizations

Body

Response