Accounts

Manage your connected LinkedIn accounts programmatically. For general Admin API information, see the Admin overview. To connect a new account or reconnect an existing one, see Connection Sessions.

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",
        "url": "https://www.linkedin.com/in/johndoe/",
        "avatarUrl": "https://media.licdn.com/dms/image/...",
        "headline": "Founder at Example",
        "countryCode": "US",
        "identificationToken": "id_...",
        "status": "active",
        "connectedAt": "2026-02-20T11:11:51.732Z"
      },
      {
        "id": "a91c20f8-...",
        "name": "Jane Doe",
        "url": "https://www.linkedin.com/in/janedoe/",
        "avatarUrl": null,
        "headline": null,
        "countryCode": "US",
        "identificationToken": "id_...",
        "status": "reconnection_required",
        "connectedAt": "2026-01-12T09:30:00.000Z",
        "reconnectionSessionId": "d90ac1f6-...",
        "reconnectionLink": "https://app.linkedapi.io/connection/d90ac1f6-..."
      }
    ],
    "pendingConnectionSessions": [
      {
        "sessionId": "990eef7a-...",
        "status": "pending"
      }
    ]
  }
}

Account fields:

Field	Type	Description
`id`	`string`	Account UUID
`name`	`string`	LinkedIn account name
`url`	`string`	Public LinkedIn profile URL for the connected account
`avatarUrl`	`string \	null`	LinkedIn profile image URL, or `null` when it has not been parsed yet
`headline`	`string \	null`	LinkedIn headline shown below the account name, or `null` when it has not been parsed yet
`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
`reconnectionSessionId`	`string`	Present only when `status` is `reconnection_required`; session UUID for reconnecting the account
`reconnectionLink`	`string`	Present only when `status` is `reconnection_required`; URL to open in a browser to reconnect the account

When an account is reconnection_required, accounts.getAll returns an active reconnection session. If no active reconnection session exists, one is created automatically before the response is returned.

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

Refresh the stored profile information for a connected LinkedIn account. This starts a background workflow that opens the account's own LinkedIn session and reparses the account name, public profile URL, avatar URL, and headline. The refreshed values are returned by accounts.getAll after the workflow completes.

bash

curl -X POST https://api.linkedapi.io/admin/accounts.reparseAccountInfo \
  -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 refresh

Response:

json

{
  "success": true,
  "result": {
    "workflowId": "reparseAccountInfoWorkflow-..."
  }
}

Notes:

The response confirms that the reparse workflow was started; it does not include the refreshed account object.
Call accounts.getAll after the workflow completes to read the updated url, avatarUrl, and headline fields.
avatarUrl and headline can remain null if LinkedIn does not render those values or the account session needs reconnection.

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.

PreviousSubscription NextConnection Sessions