Skip to main content
POST
Create a Company.

Authorizations

x-api-key
string
header
required

Body

application/json
acquisition_status
string | null
business_model
string | null
city
string | null

City name, e.g. 'Los Angeles'.

company_custom_fields
Company Custom Fields · object | null

Internal/custom field values to set, keyed by the field's key from GET /v1/companies/custom-fields (not its UUID — values under a UUID are stored but never shown in the web app). Replaces the entire object on write — there is no per-key merge, so a partial update must resend every key it wants to keep.

company_name
string | null
company_type
string | null
country
string | null

ISO 3166-1 alpha-2 country code, e.g. 'US'.

description
string | null
email
string | null
employee_count
string | null

Employee count band, not an exact number — a range string like '11-50' or the sentinel '10000+' (matches the format used by GET /v1/companies' employee_count_from/to filters).

facebook_url
string | null
ipo_status
string | null
linkedin_url
string | null
logo_url
string | null
operating_status
string | null
phone
string | null
region
string | null

Free-text geographic region label, stored as given. Not resolved against any code table and not used by the GET /v1/companies location filters.

sector
string | null
state
string | null

Full ISO 3166-2 subdivision code including the country prefix — 'US-CA', not 'CA' and not 'California'. Note this is NOT the same vocabulary as the state filter on GET /v1/companies, which takes a name or a country-scoped code; reads resolve this field through the code table, so a name stored here will not resolve to a state.

street_address
string | null
thesis_area
string | null
twitter_url
string | null
website
string | null
year_founded
string | null

Response

201 - application/json

Response body for company create/update.

rings_updated_at
integer
required
uuid
string
required