Write

Add or Update Company

Add or update a company record, looking it up by LinkedIn company ID (preferred) or by a name plus website fallback. You can set industry, headcount, headquarters, website, tags, custom attributes, external IDs, and notes, with custom attributes merged into any existing values. Fires a company.created or company.updated webhook, and fails if neither a LinkedIn company ID nor a name is provided.

upsert_companyPOST/api/v1/companies

Get started View docs

crispy — bash

Example prompt: Add or update the company Acme Analytics with LinkedIn ID 1441, industry software, 180 employees, and tag it tier-A

{
  "id": "co_8821",
  "name": "Acme Analytics",
  "linkedin_company_id": "1441",
  "created": false,
  "updated": true
}

Permission scope

core

Access

Write

What you can build

Create or enrich account records with firmographics and CRM identifiers

Attach custom personalization variables to a company for campaign messaging

Keep company data in sync by upserting on a stable LinkedIn ID

Tag and annotate target accounts for segmentation and reporting

Parameters

Inputs accepted by upsert_company.

Name	Type	Required	Description
linkedin_company_id	`string`	optional	LinkedIn numeric/slug company ID (preferred upsert key).
name	`string`	required	Company name. Required if linkedin_company_id absent.
industry	`string[]`	optional	Industry tags.
headcount	`number`	optional	Approximate employee count.
employee_count	`number`	optional	Employee count (alias for headcount).
headquarters	`object`	optional	{ city, country, ... }
website	`string`	optional	Company website URL.
tags	`string[]`	optional	Tags for categorization.
custom_attrs	`object`	optional	Custom personalization vars (max 100 string keys, 1KB total). Merged with existing.
external_ids	`object`	optional	Stable third-party identifiers (CRM IDs, enrichment IDs).
notes	`string`	optional	Free-text notes about the company.

Related tools

List and Export Companies

Query and export your saved companies with rich filtering by industry, headcount, location, tags, and custom attributes. Returns JSON or CSV.

Get LinkedIn Company

Look up a single LinkedIn company by ID and optionally include its linked contacts and cached outreach stats. Fast, accurate company records for your AI agent.

Get Company Profile

Fetch a company's LinkedIn page by name or ID, returning description, employee count, industry, and follower count. Cached for fast, repeated lookups.

Search LinkedIn Companies

Search LinkedIn for companies by keyword, industry, location, or headcount. Returns a company ID per result, with Sales Navigator routing for advanced filters.

Explore all Prospecting tools

The complete LinkedIn API. Ready when you are.

Connect your first LinkedIn profile in under 5 minutes. Every tool, every seat, no feature gates. Safe limits, warm-up, and full permission control built in.

Start now Read the docs