API referenceConnect

POST /api/v1/connect/linkedin

Connect (or with accountId reconnect) a LinkedIn account with the member's own web session: cookies (li_at and JSESSIONID at least) and the user agent of the browser they came from. No OAuth, no password. country (ISO-3166 alpha-2, required) and city (optional) choose where the server-side residential proxy the session goes through exits; any proxy sent by the caller is ignored. The jar is validated, sealed (encrypted) and stored; responses never contain cookie values. While approval applies to the key, the organization or the account, the connect is queued (202, kind account.linkedin_connect, the queued call carries the jar already sealed). Availability: PROVIDER_LIVE_LINKEDIN_SESSION (or mock outside production)

POST
/api/v1/connect/linkedin

Authorization

BearerAuth
headerAuthorizationBearer <token>

API key sk_...

Request Body

application/json
  1. body
cookies*|array<>

Session cookies; must include li_at and JSESSIONID. JSON body only, never the query string (400)

userAgent*string

User agent of the browser that minted the session

Lengthlength <= 1024
country*string

ISO-3166 alpha-2 code (any case) of the country the member uses LinkedIn from; the session goes out through a residential proxy there

Match^[a-zA-Z]{2}$
city?string

Optional city within that country (e.g. "Buenos Aires"); normalized to lowercase ASCII with underscores

Lengthlength <= 100
accountId?string

Reconnect this existing LinkedIn account

externalId?string

Your reference, stored on the account

Lengthlength <= 200

Response Body

{platform, account, verification}: the session account (never the cookies). verification is unverified until live verification is enabled

application/json
  1. response
platform*"linkedin"
Value in"linkedin"
account*
verification*string
Example Request
curl -X POST 'https://example.com/api/v1/connect/linkedin' \  -H 'Content-Type: application/json' \  -d '{  "cookies": {    "property1": "string",    "property2": "string"  },  "userAgent": "string",  "country": "string"}'
Example Response
{  "platform": "linkedin",  "account": {    "id": "string",    "socialAccountId": "string",    "status": "active",    "source": "ui",    "userAgent": "string",    "connectedAt": "2019-08-24T14:15:22Z"  },  "verification": "string"}

GET /api/v1/connect/linkedin GET

Not supported: LinkedIn session connect has no OAuth link. POST the session cookies instead

GET /api/v1/connect/pending GET

Unexpired pending connections of this organization, newest first (options without tokens). Use it, or the connection.pending webhook, to learn the id after an API-started Facebook connect