Skip to Content
Inbox

LinkedIn accounts

The LinkedIn accounts your campaigns send from, and hosted sessions to connect them.

Inbox6 endpointsKen-Version: 2026-11-02AuthenticationWorkspacesErrors
MarkdownOpenAPI

Path parameters

The endpoints whose path names one of these take it as described here. An endpoint's own table lists a path parameter only when it describes it differently.

NameInTypeRequiredDescription
linkedinAccountIdpathinteger (int64)requiredThe LinkedIn account's id.

Headers

The endpoints on this page take these headers. Each endpoint's curl shows the ones it sends.

NameInTypeRequiredDescription
Ken-Versionheaderstring, one of: 2026-11-02, 1.1optionalThe API version, a date in YYYY-MM-DD form. 1.1 is another name for the first dated version. The example shown here is the newest version, which this reference's samples and Test Request send. Leave it out to use your API key's pinned version. Keys created in the Kenso app are pinned to the newest version; keys minted by the CLI login are not. A key with no pinned version and no header gets the legacy shape where the path has one, and 404 where the path exists only in this version. A date that is not a version answers 400 unsupported_version; any other value that is not a version is treated as legacy.
X-Ken-Workspace-Idheaderinteger (int64)optionalThe id of the workspace to act in. Leave it out when your API key reaches only one workspace. When the key reaches more than one, a request without this header answers 400 workspace_required. A workspace you are not a member of answers 404 not_found.

List LinkedIn accounts

GET/v1/linkedin-accountslinkedin-accounts.list
Permission
Delivery view
Rate limit
12,000 requests a minute per API key

Try it on developer.ken.so

Returns the workspace's LinkedIn accounts, a page at a time with limit and cursor. Each account carries today's usage, its safety caps and holds, its tags and the live campaigns that use it.

Errors:

  • 400 validation_failed: limit is not from 1 to 200, or cursor is invalid.

Requires Delivery view.

Parameters

NameInTypeRequiredDescription
cursorquerystringoptionalThe pagination.nextCursor value from the previous page. Omit it for the first page.
limitqueryinteger (int32)optionalHow many LinkedIn accounts to return, from 1 to 200. Defaults to 50.
Request
curl -X GET "https://api.ken.so/v1/linkedin-accounts?limit=50" \
  -H "Authorization: Bearer $KENSO_API_KEY" \
  -H "Ken-Version: 2026-11-02" \
  -H "X-Ken-Workspace-Id: $KENSO_WORKSPACE_ID"

Response 200

data is a list of LinkedInAccount. Each item has these fields. The response also carries pagination.

Show the 48 response fields and an example

The fields and an example are also on this endpoint's Markdown page.

Get a LinkedIn account

GET/v1/linkedin-accounts/{linkedinAccountId}linkedin-accounts.get
Permission
Delivery view
Rate limit
12,000 requests a minute per API key

Try it on developer.ken.so

Returns one LinkedIn account with today's usage, its safety caps and holds, its tags and the live campaigns that use it.

Errors:

  • 404 not_found: no LinkedIn account with this id in the workspace.

Requires Delivery view.

Request
curl -X GET "https://api.ken.so/v1/linkedin-accounts/812" \
  -H "Authorization: Bearer $KENSO_API_KEY" \
  -H "Ken-Version: 2026-11-02" \
  -H "X-Ken-Workspace-Id: $KENSO_WORKSPACE_ID"

Response 200

data is a LinkedInAccount.

Show the 48 response fields and an example

The fields and an example are also on this endpoint's Markdown page.

Update a LinkedIn account

PATCH/v1/linkedin-accounts/{linkedinAccountId}linkedin-accounts.update
Permission
Delivery edit
Rate limit
4,800 requests a minute per API key

Try it on developer.ken.so

Changes the fields you send and leaves the others unchanged.

  • displayName: at most 255 characters.
  • timezone: an IANA time zone such as Europe/Bucharest. An empty string clears it, and the account then works in UTC.
  • workingHoursSchedule: the account's hours for each of the seven days, in its time zone. Send it or workingHours, not both.
  • dailyInviteCap, dailyMessageCap, dailyVisitCap: daily limits. Kenso clamps each value to at least 1 and at most the platform maximum, which is at most 20 invites, 50 messages and 80 visits a day.
  • paused: true pauses outreach from the account and sets pausedAt, or keeps it when the account is already paused. Campaign invites, messages, InMails, profile visits, withdrawals, approved Accounts notes and Ken's autonomous replies wait. Kenso never fails them or moves them to email. false resumes the account and clears pausedAt. Replies a member sends from the Inbox and inbox sync keep running.
  • importConnections: turns the import of the account's LinkedIn connections into Accounts on or off. Only the member who connected the account or a workspace admin may change it. importConnectionsChangedAt moves only when the value changes.
  • networkOnly: true makes the account network-only. Kenso keeps syncing its connections and chats, takes it out of every campaign it sends for and lists those campaigns in removedFromCampaignIds, and never sends from it on its own. false makes it a full account again, in no campaign until one adds it. Only the member who connected the account or a workspace admin may change it. An account a Network member connected stays network-only while they have that role: change their role to a team role first.
  • researchReads: true lets Kenso read public LinkedIn posts on the account a few times a day, inside its working hours, and sets researchReadsEnabledAt. false turns that off. Only the member who connected the account may turn it on; that member or a workspace admin may turn it off.
  • ramp: edits the per-action ramp while rampPlansEnabled is true, an object keyed by action (invite, message, visit, follow, reaction, comment, endorse, accept) whose values take start, stepPerWeek and ceiling. Absent numbers keep the current value, and values are clamped to each action's hard ceiling. While rampPlansEnabled is true the three daily caps also set the invite, message and visit ceilings, and a ramp entry for the same action wins.

Errors:

  • 400 validation_failed: a value is invalid, and the error names the field. Detail code feature_off on importConnections when the workspace does not have the linkedin_connections_import feature, on networkOnly: true when it does not have warm_paths_v2, and on ramp while rampPlansEnabled is false. Detail code invalid or duplicate on ramp.<key> for an unknown or repeated action. Kenso writes nothing.
  • 403 forbidden: importConnections, networkOnly or researchReads: false from a member who did not connect the account and is not a workspace admin, researchReads: true from anyone but the member who connected it, or detail code network_member on networkOnly: false for an account a Network member connected. Kenso writes nothing.
  • 404 not_found: no LinkedIn account with this id in the workspace.

Requires Delivery edit.

Request body

application/json, optional.

FieldTypeRequiredDescription
displayNamestringoptionalThe account's name as Kenso shows it, at most 255 characters.
timezonestringoptionalAn IANA time zone, such as Europe/Bucharest. An empty string clears it, and the account then works in UTC.
workingHoursstringoptionalThe working hours as a JSON string, keyed mon to sun. Prefer workingHoursSchedule, and send only one of the two.
workingHoursScheduleLinkedInWeeklyScheduleoptionalThe account's working hours for all seven days, mon to sun, each with open, start and end. Times are HH:mm in the account's time zone. start and end are required on an open day, and at least one day must be open. An invalid day returns 400 validation_failed that names it.
dailyInviteCapinteger (int32)optionalThe most connection invites per day. Kenso keeps it between 1 and the platform maximum, at most 20.
dailyMessageCapinteger (int32)optionalThe most messages and InMails per day. Kenso keeps it between 1 and the platform maximum, at most 50.
dailyVisitCapinteger (int32)optionalThe most profile visits per day. Kenso keeps it between 1 and the platform maximum, at most 80.
pausedbooleanoptionalSet to true to pause outreach from the account: campaign invites, messages, InMails, profile visits, withdrawals, approved Accounts notes and Ken's autonomous replies wait. An account already paused keeps its first pausedAt. false resumes it, and the waiting actions go on where they stopped. Replies a member sends from the Inbox and inbox sync keep running while paused. Omit it or send null to leave the pause as it is.
importConnectionsbooleanoptionalSet to true to import the account's LinkedIn connections into Accounts as people and companies. false stops new imports and keeps what was already imported. Only the member who connected the account or a workspace admin may send it, and the workspace needs the linkedin_connections_import feature. Omit it or send null to leave it as it is.
networkOnlybooleanoptionalSet to true to make the account network-only: Kenso keeps syncing its connections and chats, takes it out of every campaign it sends for (the response lists them in removedFromCampaignIds) and never sends from it on its own. false makes it a full account again; it joins no campaign by itself. Only the member who connected the account or a workspace admin may send it, and true needs the warm_paths_v2 feature (false does not). false is refused for an account a Network member connected. Omit it or send null to leave it as it is.
handoffsMutedbooleanoptionalSet to true to mute warm path handoffs: while it is set, no teammate's warm path hands you a hop through this or any other account you own (their Start is refused with guardrail_handoff_muted). false unmutes this account. Only the member who connected the account or a workspace admin may send it, and true needs the warm_paths_v2 feature (false does not). Omit it or send null to leave it as it is.
researchReadsbooleanoptionalSet to true to turn on research reads: Kenso may then read public LinkedIn posts on this account a few times a day, inside its working hours, and researchReadsEnabledAt is set. false turns them off. Only the member who connected the account may send true; that member or a workspace admin may send false. Omit it or send null to leave it as it is.
rampmap of LinkedInRampActionEditoptionalPer-action ramp edits, accepted only while the account's rampPlansEnabled is true (otherwise 400 validation_failed, code feature_off). An object keyed by action (invite, message, visit, follow, reaction, comment, endorse, accept): { "invite": { "start": 5, "stepPerWeek": 5, "ceiling": 20 } }. Each value takes any of start, stepPerWeek and ceiling; absent numbers keep the current value, and every value is clamped to the action's hard ceiling. While rampPlansEnabled is true, dailyInviteCap, dailyMessageCap and dailyVisitCap also set the invite, message and visit ceilings; a ramp entry for the same action wins.
Request
curl -X PATCH "https://api.ken.so/v1/linkedin-accounts/812" \
  -H "Authorization: Bearer $KENSO_API_KEY" \
  -H "Ken-Version: 2026-11-02" \
  -H "X-Ken-Workspace-Id: $KENSO_WORKSPACE_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "displayName": "string",
  "timezone": "Europe/Bucharest",
  "workingHours": "string",
  "workingHoursSchedule": {
    "mon": {
      "open": true,
      "start": "09:00",
      "end": "17:30"
    },
    "tue": {
      "open": true,
      "start": "09:00",
      "end": "17:30"
    },
    "wed": {
      "open": true,
      "start": "09:00",
      "end": "17:30"
    },
    "thu": {
      "open": true,
      "start": "09:00",
      "end": "17:30"
    },
    "fri": {
      "open": true,
      "start": "09:00",
      "end": "17:30"
    },
    "sat": {
      "open": true,
      "start": "09:00",
      "end": "17:30"
    },
    "sun": {
      "open": true,
      "start": "09:00",
      "end": "17:30"
    }
  },
  "dailyInviteCap": 1,
  "dailyMessageCap": 1,
  "dailyVisitCap": 1,
  "paused": true,
  "importConnections": true,
  "networkOnly": true,
  "handoffsMuted": true,
  "researchReads": true,
  "ramp": {
    "key": {
      "start": 1,
      "stepPerWeek": 1,
      "ceiling": 1
    }
  }
}'

Response 200

data is a LinkedInAccount.

Show the 48 response fields and an example

The fields and an example are also on this endpoint's Markdown page.

Delete a LinkedIn account

DELETE/v1/linkedin-accounts/{linkedinAccountId}linkedin-accounts.delete
Permission
Delivery edit
Rate limit
4,800 requests a minute per API key

Try it on developer.ken.so

Disconnects the account from LinkedIn, removes it from the workspace and frees its LinkedIn seat on your plan. Returns 204.

Errors:

  • 404 not_found: no LinkedIn account with this id in the workspace, including one you already deleted.
  • 503 service_unavailable: LinkedIn is rate limited and Kenso removed nothing. Try again shortly.

Requires Delivery edit.

Request
curl -X DELETE "https://api.ken.so/v1/linkedin-accounts/812" \
  -H "Authorization: Bearer $KENSO_API_KEY" \
  -H "Ken-Version: 2026-11-02" \
  -H "X-Ken-Workspace-Id: $KENSO_WORKSPACE_ID"

Response 204

Response 204
HTTP/1.1 204 No Content

Start a LinkedIn connect session

POST/v1/linkedin-accounts/connect-sessionslinkedin-accounts.create-connect-session
Permission
Any workspace member, Network members included
Credits
1,500 credits per LinkedIn account a month (linkedin_account_monthly)
Rate limit
10 requests a minute per API key

Try it on developer.ken.so

Returns a hosted link where the member signs in to LinkedIn to connect a new account or reconnect an existing one. Open url within one hour.

Omit linkedInAccountId to connect a new account. Kenso creates the account with status connecting and returns its id. Send linkedInAccountId (or linkedinAccountId) to reconnect that account, for example when its status is credentials_error or disconnected. importConnections: true on a new account imports its LinkedIn connections into Accounts once it connects. It needs the linkedin_connections_import feature and is ignored without it. A reconnect ignores importConnections and keeps the account's setting. networkOnly: true connects a network-only account: Kenso syncs its connections and chats but never adds it to a campaign or sends from it on its own. It needs the warm_paths_v2 feature. A reconnect ignores networkOnly and keeps the account's setting. A Network member's account is always network-only: Kenso connects it network-only whatever networkOnly says, and a reconnect makes an account they connected network-only. It still takes a LinkedIn seat on your plan.

Any member may call it, Network members included. A member with Delivery edit can connect a new account and reconnect any account. A member with only the approve_own_sends permission, a Network member among them, can connect one account of their own and reconnect only that one.

Errors:

  • 400 validation_failed: LinkedIn outreach is not on for this workspace, or detail code feature_off on networkOnly when the workspace does not have the warm_paths_v2 feature.
  • 402 plan_limit_reached: the plan has no LinkedIn seat left, or the workspace's credits do not cover the account's first month.
  • 402 trial_cap_reached: the workspace is on the Growth trial and already holds its one LinkedIn or WhatsApp account. error.refusal names the cap (linkedin_accounts) and offers Upgrade.
  • 403 permission_denied: the caller has neither Delivery edit nor approve_own_sends.
  • 403 forbidden, detail code not_your_linkedin: a member with only approve_own_sends asked to reconnect another member's account.
  • 404 not_found: linkedInAccountId is not an account in this workspace.
  • 409 conflict, detail code reconnect_instead: a member with only approve_own_sends already has an account here. The message names the id to reconnect.
  • 503 service_unavailable: LinkedIn is rate limited. Try again shortly.

Open to any workspace member.

Request body

application/json, optional.

FieldTypeRequiredDescription
linkedInAccountIdinteger (int64)optionalThe LinkedIn account to reconnect. Omit it to connect a new account. linkedinAccountId is accepted too, and both must match when you send both.
importConnectionsbooleanoptionalSet to true to import the new account's LinkedIn connections into Accounts once it connects. It needs the linkedin_connections_import feature and is ignored without it. A reconnect ignores it and keeps the account's setting.
networkOnlybooleanoptionalSet to true to connect a network-only account: Kenso syncs its LinkedIn connections and chats so the workspace can find warm paths through them, but never adds it to a campaign or sends from it on its own. It needs the warm_paths_v2 feature: without it true is refused. A reconnect ignores it and keeps the account's setting. A Network member's account is network-only whatever this says.
Request
curl -X POST "https://api.ken.so/v1/linkedin-accounts/connect-sessions" \
  -H "Authorization: Bearer $KENSO_API_KEY" \
  -H "Ken-Version: 2026-11-02" \
  -H "X-Ken-Workspace-Id: $KENSO_WORKSPACE_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "linkedInAccountId": 812,
  "importConnections": true,
  "networkOnly": true
}'

Response 201

data is a LinkedInConnectSession.

Show the 2 response fields and an example

The fields and an example are also on this endpoint's Markdown page.

Restart a LinkedIn account's ramp

POST/v1/linkedin-accounts/{linkedinAccountId}/ramp/resetlinkedin-accounts.reset-ramp
Permission
Delivery edit
Rate limit
4,800 requests a minute per API key

Try it on developer.ken.so

Restarts the account's per-action ramp from today. Each action keeps its start, weekly step and ceiling, and rampStartedAt moves to now, so every action is back at its start value today. Returns the account.

Errors:

  • 404 not_found: no LinkedIn account with this id in the workspace.
  • 409 invalid_state: LinkedIn caps still follow the ramp stages (rampPlansEnabled is false), so there is no ramp to restart.

Requires Delivery edit.

Request
curl -X POST "https://api.ken.so/v1/linkedin-accounts/812/ramp/reset" \
  -H "Authorization: Bearer $KENSO_API_KEY" \
  -H "Ken-Version: 2026-11-02" \
  -H "X-Ken-Workspace-Id: $KENSO_WORKSPACE_ID"

Response 200

data is a LinkedInAccount.

Show the 48 response fields and an example

The fields and an example are also on this endpoint's Markdown page.


On this page