Skip to content

Companies

Look up company records — get a single company by ID or list the companies linked to a workspace.

Full name: campaignstack_get_company

leads:read Read-only Idempotent

Get a company by ID. Accepts a shared (global) company id or an imported workspace-scoped company id; the response’s companySource field says which one matched. Returns industry, employee range, and contact info. Platform presence (LinkedIn URL, follower/staff counts, tagline) is under the profiles key (e.g. profiles.linkedin.url); top-level LinkedIn fields are legacy aliases. The watch key carries the workspace’s intelligence post watch on this company (id, status, post count) when one exists. Call this when the user names one company and asks about it, or before editing it. It does not list which leads work there, campaignstack_search_leads does. If the company is not found, use campaignstack_list_companies to find valid company IDs.

NameTypeRequiredDefaultDescription
companyIdstringYes(min length: 1)
workspaceIdstringNoOnly needed for imported (workspace-scoped) companies. Workspace ID (required for user keys; workspace keys are bound)

Full name: campaignstack_list_companies

leads:read Read-only Idempotent

List companies linked to a workspace. Returns company records with workspace metadata (tags, notes, addedAt). Supports cursor-based pagination. Call this when the user asks to see or search the companies in a workspace, or to find a company id before another call. Use the returned companyId values with campaignstack_get_company. Results are one page. When pagination reports more, say so rather than presenting the page as the whole set, and page through before counting anything.

NameTypeRequiredDefaultDescription
workspaceIdstringNoWorkspace 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.
limitintegerNo20(min: 1, max: 100)
cursorstringNo