LinkedIn Accounts
Monitor LinkedIn account health, status, budget usage, and ramp-up state.
Tools (7)
Section titled “Tools (7)”list_accounts
Section titled “list_accounts”Full name: campaignstack_list_accounts
List accounts connected to a workspace. Returns LinkedIn and Google accounts with a platform field. Optionally filter by platform (‘linkedin’ or ‘google’). LinkedIn accounts include today’s budget usage; Google accounts include email and status. Call this when the user asks which accounts are connected, or to find an accountId. It does not connect a new account: that happens in the CampaignStack app.
Parameters
Section titled “Parameters”| Name | Type | Required | Default | Description |
|---|---|---|---|---|
workspaceId | string | Yes | — | Workspace ID. REQUIRED for a user key (csu_), which spans every workspace you belong to; omitted for a workspace key (cs_), which is bound to one and ignores this argument. campaignstack_whoami reports which kind of key you are holding and, for a user key, the workspaces it can reach. (min length: 1) |
platform | linkedin | google | No | — | Filter by platform. Omit to return all accounts. |
get_platform_capabilities
Section titled “get_platform_capabilities”Full name: campaignstack_get_platform_capabilities
Lists every platform action (like_post, comment_on_post, follow_profile, send_message, send_connection_request, send_inmail, extract_post_engagements) with the platforms it supports and, per platform, the accepted target fields and optional params. Returns platforms, which says for each platform whether accounts can be connected, how many this workspace has, and which actions exist there: a platform with no actions is tracking-only by design, not unfinished. connectedPlatforms is the older shape and lists only platforms with a connected account. Call this when an action tool returns wrong_target_for_platform or unsupported_capability.
Parameters
Section titled “Parameters”| Name | Type | Required | Default | Description |
|---|---|---|---|---|
workspaceId | string | No | — | Workspace ID. REQUIRED for a user key (csu_), which spans every workspace you belong to; omitted for a workspace key (cs_), which is bound to one and ignores this argument. campaignstack_whoami reports which kind of key you are holding and, for a user key, the workspaces it can reach. |
get_account
Section titled “get_account”Full name: campaignstack_get_account
Get detailed account health info including status, budget usage per action type, ramp-up state, and last activity timestamps. Requires platform (‘linkedin’ or ‘google’) and accountId. Use campaignstack_list_accounts to find valid accountId values. Call this after campaignstack_list_accounts, before dispatching outreach, to check today’s budget. It does not split CampaignStack’s sends from the rest: campaignstack_get_account_safety does.
Parameters
Section titled “Parameters”| Name | Type | Required | Default | Description |
|---|---|---|---|---|
platform | linkedin | google | Yes | — | Platform of the account to retrieve |
accountId | string | Yes | — | (min length: 1) |
start_connections_export
Section titled “start_connections_export”Full name: campaignstack_start_connections_export
Start an async runner job that exports the 1st-degree LinkedIn connections for the given account as leads. The job runs in the background. Use campaignstack_get_automation_jobs to monitor progress. Each account has ONE connections list per workspace (source ‘linkedin_connections’): the first export creates it, every later export refreshes it in place (connections are added, never removed). The job result carries leadListId. Pass keepUpToDate to subscribe the list to new connections. Use campaignstack_list_accounts to find valid accountId values (platform: ‘linkedin’). Call this when the user wants an account’s connections turned into a lead list. It does not send new connection requests: campaignstack_send_connection_request does that, one at a time.
Parameters
Section titled “Parameters”| Name | Type | Required | Default | Description |
|---|---|---|---|---|
accountId | string | Yes | — | (min length: 1) |
workspaceId | string | Yes | — | (min length: 1) |
maxConnections | integer | No | — | Maximum number of connections to export (default 2500) (max: 10000) |
listName | string | No | — | Name for the connections list. Used only when the account has no connections list in this workspace yet; an existing list keeps its name. (min length: 1, max length: 120) |
keepUpToDate | boolean | No | — | Keep the list current: new connections are added automatically from the account’s daily connection read, at no extra LinkedIn activity. Default false (one-shot export). |
get_private_proxy
Section titled “get_private_proxy”Full name: campaignstack_get_private_proxy
Get the private proxy connection info (host, port, username; never the password) for a LinkedIn account, or null if the account is on a shared pool proxy. You can only read proxies for accounts in your own workspace. Call this before campaignstack_set_private_proxy or campaignstack_remove_private_proxy to check which mode an account is on. It never returns the password.
Parameters
Section titled “Parameters”| Name | Type | Required | Default | Description |
|---|---|---|---|---|
accountId | string | Yes | — | (min length: 1) |
workspaceId | string | Yes | — | Workspace ID. REQUIRED for a user key (csu_), which spans every workspace you belong to; omitted for a workspace key (cs_), which is bound to one and ignores this argument. campaignstack_whoami reports which kind of key you are holding and, for a user key, the workspaces it can reach. (min length: 1) |
set_private_proxy
Section titled “set_private_proxy”Full name: campaignstack_set_private_proxy
Set (or replace) a private ‘bring-your-own’ HTTP proxy on a LinkedIn account. The proxy is TESTED first; if it cannot reach LinkedIn, NOTHING changes (the current proxy keeps serving runs) and an error is returned. On success the account uses your proxy and any shared pool proxy is released. Use campaignstack_list_accounts to find valid accountId values (platform: ‘linkedin’). Call this when the user has their own proxy for one account. It takes a password, so CampaignStack refuses this call from a connected app: use an API key or the account’s settings in the app.
Parameters
Section titled “Parameters”| Name | Type | Required | Default | Description |
|---|---|---|---|---|
accountId | string | Yes | — | (min length: 1) |
workspaceId | string | Yes | — | Workspace ID. REQUIRED for a user key (csu_), which spans every workspace you belong to; omitted for a workspace key (cs_), which is bound to one and ignores this argument. campaignstack_whoami reports which kind of key you are holding and, for a user key, the workspaces it can reach. (min length: 1) |
host | string | Yes | — | (min length: 1) |
port | integer | Yes | — | (min: 1, max: 65535) |
username | string | No | — | |
password | string | No | — |
remove_private_proxy
Section titled “remove_private_proxy”Full name: campaignstack_remove_private_proxy
Remove the private proxy from a LinkedIn account and revert it to a shared pool proxy. No-op if the account is already on a shared proxy. Call this when the user’s proxy stopped working and the account should fall back to the shared pool. campaignstack_set_private_proxy tests and applies a replacement instead.
Parameters
Section titled “Parameters”| Name | Type | Required | Default | Description |
|---|---|---|---|---|
accountId | string | Yes | — | (min length: 1) |
workspaceId | string | Yes | — | Workspace ID. REQUIRED for a user key (csu_), which spans every workspace you belong to; omitted for a workspace key (cs_), which is bound to one and ignores this argument. campaignstack_whoami reports which kind of key you are holding and, for a user key, the workspaces it can reach. (min length: 1) |