Skip to main content

companies.create

Record a company

Request
POST/api/v1/companies
Scope required
companies:write
Effect
Changes data. Send an Idempotency-Key if you might retry it.
Acts on
Acts on the account’s own job search.
MCP tool
companies_create
Environment
Live and sandbox alike.
Request body
JSON.

What it does

Creates an employer on the account without filing an application against it, for building a shortlist before applying. Filing an application with `applications.create` already creates the company it names, so reach for this only when there is no application yet. A name the account already uses is refused with 409, because the card editor offers employers by name and two of them would be indistinguishable. Everything but `name` is optional.

Request body

industry
one of: agriculture, arts, automotive, banking, biotechnology, chemical, communications, construction, consulting, education, electronics, energy, engineering, entertainment, environmental, finance, food, government, healthcare, hospitality, insurance, legal, manufacturing, media, non_profit, pharmaceutical, real_estate, retail, software, sports, technology, telecommunications, transportation, travel, other, unknown, optional
linkedin
string or null, optional
name
string, required
notes
string or null, optional
size
one of: tiny, small, medium, large, massive or null, optional
type
one of: government_agency, non_profit, private, public or null, optional
website
string or null, optional

Response

applicationCount
integer, required
createdAt
string, required
id
string, required
industry
one of: agriculture, arts, automotive, banking, biotechnology, chemical, communications, construction, consulting, education, electronics, energy, engineering, entertainment, environmental, finance, food, government, healthcare, hospitality, insurance, legal, manufacturing, media, non_profit, pharmaceutical, real_estate, retail, software, sports, technology, telecommunications, transportation, travel, other, unknown, required
linkedin
string or null, required
name
string, required
notes
string or null, required
size
one of: tiny, small, medium, large, massive or null, required
type
one of: government_agency, non_profit, private, public or null, required
updatedAt
string, required
website
string or null, required

Examples

Shortlist an employer before applying

Shortlist an employer before applying — request
curl -s -X POST https://www.jobapplicationtracking.com/api/v1/companies \
  -H "Authorization: Bearer $JAT_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Northwind",
  "industry": "software"
}'
Shortlist an employer before applying — response
{
  "id": "co_42",
  "name": "Northwind",
  "industry": "software",
  "size": "medium",
  "type": "private",
  "website": "https://northwind.example",
  "linkedin": null,
  "notes": null,
  "applicationCount": 0,
  "createdAt": "2026-01-04T09:30:00.000Z",
  "updatedAt": "2026-02-11T17:05:00.000Z"
}

Related operations