Skip to main content
POST
Execute custom LinkedIn request (escape hatch)

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 execute_linkedin_custom_request.

linkedin_account_sid
string
required

REQUIRED executor: the OWN account (ln_ac_…) the call runs on. There is NO pool fallback (an arbitrary call must never run under a shared infra account).

Required string length: 18
Pattern: ^ln_ac_
url
string
required

Absolute LinkedIn URL (e.g. "https://www.linkedin.com/voyager/api/…") or a bare path (resolved against https://www.linkedin.com). MUST match the server host + path allowlist (provisional: *.linkedin.com + path prefixes /voyager/api/, /sales-api/). Otherwise 403 forbidden_endpoint.

Required string length: 1 - 2048
method
enum<string>

HTTP verb, default GET. Write-shaped verbs (PUT/DELETE/PATCH) are out of scope at launch (SAFETY).

Available options:
GET,
POST
headers
object

Extra request headers merged onto the default voyager headers.

body

POST JSON body (object → JSON-encoded) or raw string (passed through); ≤ 50 KB serialized; null/omitted for GET.

form
boolean

Modifier: when true, send body as application/x-www-form-urlencoded (NOT a separate body). POST only.

include_default_headers
boolean

Inject the plugin's default voyager headers (default true); false to send only headers.

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
meta
object
required
credits
object