Accounts

Manage your connected LinkedIn accounts programmatically. For general Admin API information, see the Admin overview.

accounts.getAll

Get all connected LinkedIn accounts and pending connection sessions.

bash

curl -X POST https://api.linkedapi.io/admin/accounts.getAll \
  -H "Content-Type: application/json" \
  -H "linked-api-token: linked_your_token_here"

Response:

json

{
  "success": true,
  "result": {
    "accounts": [
      {
        "id": "f9b4346a-...",
        "name": "John Doe",
        "countryCode": "US",
        "identificationToken": "id_...",
        "status": "active",
        "connectedAt": "2026-02-20T11:11:51.732Z"
      }
    ],
    "pendingConnectionSessions": [
      {
        "sessionId": "990eef7a-...",
        "status": "pending"
      }
    ]
  }
}

Account fields:

Field	Type	Description
`id`	`string`	Account UUID
`name`	`string`	LinkedIn account name
`countryCode`	`string`	Country code selected during connection
`identificationToken`	`string`	Token used in the `identification-token` header for Account API calls
`status`	`string`	`active`, `frozen`, or `reconnection_required`
`connectedAt`	`string`	ISO 8601 timestamp

Account statuses:

Status	Description
`active`	Account is connected and operational
`frozen`	Account is frozen (subscription downgraded or expired)
`reconnection_required`	LinkedIn session expired, account needs to be reconnected

accounts.disconnect

Disconnect a LinkedIn account. This permanently removes the account, its browser profile, and proxy.

bash

curl -X POST https://api.linkedapi.io/admin/accounts.disconnect \
  -H "Content-Type: application/json" \
  -H "linked-api-token: linked_your_token_here" \
  -d '{"accountId": "f9b4346a-..."}'

Body:

Field	Type	Required	Description
`accountId`	`string`	Yes	UUID of the account to disconnect

Response:

json

{
  "success": true,
  "result": {}
}

Warning: This action is irreversible. The account must be reconnected from scratch.

accounts.regenerateIdentificationToken

Generate a new identification-token for an account. The old token becomes invalid immediately.

bash

curl -X POST https://api.linkedapi.io/admin/accounts.regenerateIdentificationToken \
  -H "Content-Type: application/json" \
  -H "linked-api-token: linked_your_token_here" \
  -d '{"accountId": "f9b4346a-..."}'

Body:

Field	Type	Required	Description
`accountId`	`string`	Yes	UUID of the account

Response:

json

{
  "success": true,
  "result": {
    "token": "id_new_token_here"
  }
}

Important: Update the identification-token header in all your Account API integrations immediately after regeneration.

accounts.createConnectionSession

Create a new connection session to connect a LinkedIn account. Returns a link that opens the connection page where the user logs into LinkedIn.

bash

curl -X POST https://api.linkedapi.io/admin/accounts.createConnectionSession \
  -H "Content-Type: application/json" \
  -H "linked-api-token: linked_your_token_here"

Response:

json

{
  "success": true,
  "result": {
    "sessionId": "990eef7a-...",
    "connectionLink": "https://app.linkedapi.io/connection/990eef7a-..."
  }
}

Field	Type	Description
`sessionId`	`string`	Session UUID for tracking
`connectionLink`	`string`	URL to open in a browser to complete the LinkedIn login

Errors:

Type	Description
`noAvailableSeats`	No available seats – all seats are occupied by active accounts or pending connection sessions
`dailyConnectionAttemptsExceeded`	Too many connection attempts in the last 24 hours

Flow: Create session → open connectionLink → user logs into LinkedIn → poll accounts.getConnectionSession until status is success → account appears in accounts.getAll.

accounts.getConnectionSession

Check the status of a connection session.

bash

curl -X POST https://api.linkedapi.io/admin/accounts.getConnectionSession \
  -H "Content-Type: application/json" \
  -H "linked-api-token: linked_your_token_here" \
  -d '{"sessionId": "990eef7a-..."}'

Body:

Field	Type	Required	Description
`sessionId`	`string`	Yes	Session UUID

Response:

json

{
  "success": true,
  "result": {
    "session": {
      "sessionId": "990eef7a-...",
      "status": "pending",
      "type": "initial"
    }
  }
}

Session statuses:

Status	Description
`pending`	Session created, waiting for user to open the link
`preparing`	Browser is being provisioned
`serving`	Browser is ready, waiting for user to connect
`streaming`	User is connected and logging in
`success`	Login completed, account is being created
`expired`	Session timed out
`error`	An error occurred
`cancelled`	Session was cancelled

accounts.cancelConnectionSession

Cancel an active connection session.

bash

curl -X POST https://api.linkedapi.io/admin/accounts.cancelConnectionSession \
  -H "Content-Type: application/json" \
  -H "linked-api-token: linked_your_token_here" \
  -d '{"sessionId": "990eef7a-..."}'

Body:

Field	Type	Required	Description
`sessionId`	`string`	Yes	Session UUID

Response:

json

{
  "success": true,
  "result": {}
}

PreviousSubscription NextLimits