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
| Code | When |
|---|---|
conflict | Seat / pool / plan cannot connect (409) |
upstream_unavailable | Connection service temporarily unavailable |
MCP
Tool: create_linkedin_connect_link.