On this page

POST/accounts/connect-link

Credits: 0
Rate limit: 30 / minute (shared control bucket)


Purpose

Mint a short-lived self-connect hosted auth URL for LinkedIn. The user must open connectUrl in a browser and complete LinkedIn sign-in. Agents cannot complete login themselves — poll GET /accounts / GET /setup until hasConnectedAccount is true.

Seat / plan / team-pool limits are checked before minting (seat checks). Seat is also enforced again when the hosted-auth callback finishes.


Request

POST /accounts/connect-link
X-API-Key: sk_live_...

Empty body ({} or omit).


Response 200

{
  "connectUrl": "https://…",
  "expiresAt": "2026-10-21T12:00:00.000Z"
}

Self-connect links expire in about 1 hour.


Errors

CodeWhen
conflictSeat / pool / plan cannot connect (409)
upstream_unavailableConnection service temporarily unavailable

MCP

Tool: create_linkedin_connect_link.