LinkedIn accounts
The LinkedIn accounts your campaigns send from, and hosted sessions to connect them.
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.
| Name | In | Type | Required | Description |
|---|---|---|---|---|
linkedinAccountId | path | integer (int64) | required | The LinkedIn account's id. |
Headers
The endpoints on this page take these headers. Each endpoint's curl shows the ones it sends.
| Name | In | Type | Required | Description |
|---|---|---|---|---|
Ken-Version | header | string, one of: 2026-11-02, 1.1 | optional | The 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-Id | header | integer (int64) | optional | The 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
/v1/linkedin-accountslinkedin-accounts.list- Permission
- Delivery view
- Rate limit
- 12,000 requests a minute per API key
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:limitis not from 1 to 200, orcursoris invalid.
Requires Delivery view.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
cursor | query | string | optional | The pagination.nextCursor value from the previous page. Omit it for the first page. |
limit | query | integer (int32) | optional | How many LinkedIn accounts to return, from 1 to 200. Defaults to 50. |
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
/v1/linkedin-accounts/{linkedinAccountId}linkedin-accounts.get- Permission
- Delivery view
- Rate limit
- 12,000 requests a minute per API key
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.
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
/v1/linkedin-accounts/{linkedinAccountId}linkedin-accounts.update- Permission
- Delivery edit
- Rate limit
- 4,800 requests a minute per API key
Changes the fields you send and leaves the others unchanged.
displayName: at most 255 characters.timezone: an IANA time zone such asEurope/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 orworkingHours, 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:truepauses outreach from the account and setspausedAt, 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.falseresumes the account and clearspausedAt. 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.importConnectionsChangedAtmoves only when the value changes.networkOnly:truemakes the account network-only. Kenso keeps syncing its connections and chats, takes it out of every campaign it sends for and lists those campaigns inremovedFromCampaignIds, and never sends from it on its own.falsemakes 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:truelets Kenso read public LinkedIn posts on the account a few times a day, inside its working hours, and setsresearchReadsEnabledAt.falseturns 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 whilerampPlansEnabledis true, an object keyed by action (invite, message, visit, follow, reaction, comment, endorse, accept) whose values takestart,stepPerWeekandceiling. Absent numbers keep the current value, and values are clamped to each action's hard ceiling. WhilerampPlansEnabledis true the three daily caps also set the invite, message and visit ceilings, and arampentry for the same action wins.
Errors:
400 validation_failed: a value is invalid, and the error names the field. Detail codefeature_offonimportConnectionswhen the workspace does not have thelinkedin_connections_importfeature, onnetworkOnly: truewhen it does not havewarm_paths_v2, and onrampwhilerampPlansEnabledis false. Detail codeinvalidorduplicateonramp.<key>for an unknown or repeated action. Kenso writes nothing.403 forbidden:importConnections,networkOnlyorresearchReads: falsefrom a member who did not connect the account and is not a workspace admin,researchReads: truefrom anyone but the member who connected it, or detail codenetwork_memberonnetworkOnly: falsefor 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.
| Field | Type | Required | Description |
|---|---|---|---|
displayName | string | optional | The account's name as Kenso shows it, at most 255 characters. |
timezone | string | optional | An IANA time zone, such as Europe/Bucharest. An empty string clears it, and the account then works in UTC. |
workingHours | string | optional | The working hours as a JSON string, keyed mon to sun. Prefer workingHoursSchedule, and send only one of the two. |
workingHoursSchedule | LinkedInWeeklySchedule | optional | The 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. |
dailyInviteCap | integer (int32) | optional | The most connection invites per day. Kenso keeps it between 1 and the platform maximum, at most 20. |
dailyMessageCap | integer (int32) | optional | The most messages and InMails per day. Kenso keeps it between 1 and the platform maximum, at most 50. |
dailyVisitCap | integer (int32) | optional | The most profile visits per day. Kenso keeps it between 1 and the platform maximum, at most 80. |
paused | boolean | optional | Set 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. |
importConnections | boolean | optional | Set 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. |
networkOnly | boolean | optional | Set 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. |
handoffsMuted | boolean | optional | Set 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. |
researchReads | boolean | optional | Set 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. |
ramp | map of LinkedInRampActionEdit | optional | Per-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. |
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
/v1/linkedin-accounts/{linkedinAccountId}linkedin-accounts.delete- Permission
- Delivery edit
- Rate limit
- 4,800 requests a minute per API key
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.
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
HTTP/1.1 204 No ContentStart a LinkedIn connect session
/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
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 codefeature_offonnetworkOnlywhen the workspace does not have thewarm_paths_v2feature.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.refusalnames the cap (linkedin_accounts) and offers Upgrade.403 permission_denied: the caller has neither Delivery edit norapprove_own_sends.403 forbidden, detail codenot_your_linkedin: a member with onlyapprove_own_sendsasked to reconnect another member's account.404 not_found:linkedInAccountIdis not an account in this workspace.409 conflict, detail codereconnect_instead: a member with onlyapprove_own_sendsalready 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.
| Field | Type | Required | Description |
|---|---|---|---|
linkedInAccountId | integer (int64) | optional | The LinkedIn account to reconnect. Omit it to connect a new account. linkedinAccountId is accepted too, and both must match when you send both. |
importConnections | boolean | optional | Set 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. |
networkOnly | boolean | optional | Set 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. |
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
/v1/linkedin-accounts/{linkedinAccountId}/ramp/resetlinkedin-accounts.reset-ramp- Permission
- Delivery edit
- Rate limit
- 4,800 requests a minute per API key
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 (rampPlansEnabledis false), so there is no ramp to restart.
Requires Delivery edit.
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.
More in Inbox:ThreadsReply templatesScheduled messagesAttachmentsInboxesInbox importsWhatsApp accountsWhatsApp settingsAll resources