Making requests

This page explains how to make requests to Account API, including available endpoints, authorization process, response structure, and common errors.

Endpoints

https://api.linkedapi.io/account/workflows – for executing workflows.

https://api.linkedapi.io/account/conversations/poll – for polling conversations.

https://api.linkedapi.io/account/stats/actions – for checking API usage statistics.

Authorization

Requests to all endpoints must include 2 authorization headers:

• account-api-token – your main token that enables overall Account API access.
• identification-token – unique token specific to each managed LinkedIn account.

You can obtain these tokens through the Linked API Platform interface, as demonstrated below:

Response structure

All responses in Account API have the following structure:

1. For successful requests:

{
  "success": true,
  "result": { /* Endpoint specific result */ }
}

2. For requests with errors:

{
  "success": false,
  "error": { /* Common or endpoint specific error */ }
}

Common errors

Below is a list of common errors relevant to all endpoints. Additionally, some endpoints have their own specific errors, so check the related documentation pages.

accountApiTokenRequired

{
  "success": false,
  "error": {
    "type": "accountApiTokenRequired",
    "message": "'account-api-token' is missing in request headers."
  }
}

invalidAccountApiToken

{
  "success": false,
  "error": {
    "type": "invalidAccountApiToken",
    "message": "The provided 'account-api-token' is invalid."
  }
}

identificationTokenRequired

{
  "success": false,
  "error": {
    "type": "identificationTokenRequired",
    "message": "'identification-token' is missing in request headers."
  }
}

invalidIdentificationToken

{
  "success": false,
  "error": {
    "type": "invalidIdentificationToken",
    "message": "The provided 'identification-token' is invalid."
  }
}

subscriptionRequired

{
  "success": false,
  "error": {
    "type": "subscriptionRequired",
    "message": "No purchased subscription seats available for this LinkedIn account."
  }
}

invalidRequestPayload

{
  "success": false,
  "error": {
    "type": "invalidRequestPayload",
    "message": "Invalid request body/paramenters: {validation_message}."
  }
}