Skip to main content
PUT
Update a company

Authorizations

X-API-Key
string
header
required

API key (sk_xxx) from Developer Settings. No X-Account-ID needed.

Headers

x-account-id
string | null

Path Parameters

company_id
string
required

Body

application/json
name
string | null
Required string length: 1 - 255
domains
industry
string | null
company_size
string | null
employee_count
integer | null
Required range: x >= 0
annual_revenue
number | null
Required range: x >= 0
phone
string | null
email
string<email> | null
website
string | null
address
string | null
city
string | null
state
string | null
country
string | null
postal_code
string | null
linkedin_url
string | null
facebook_url
string | null
instagram_url
string | null
twitter_url
string | null
twitter_handle
string | null
twitter_follower_count
integer | null
Required range: x >= 0
description
string | null
notes
string | null
logo_url
string | null
connection_strength
string | null
status
string | null
categories
string[] | null
team_ids
string<uuid>[] | null

Person IDs for team members

associated_deal_ids
string<uuid>[] | null

Deal IDs to associate with company

metadata
Metadata · object | null
enrichment
Enrichment · object | null
enrichment_provider
string | null
enrichment_last_updated
string<date-time> | null
enrichment_status
string | null
custom_fields
Custom Fields · object | null

Response

Successful Response

id
string<uuid>
required
created_at
string<date-time>
required
updated_at
string<date-time>
required
name
string
required
Required string length: 1 - 255
account_id
string<uuid>
required
custom_fields
Custom Fields · object
required
read-only

Backward compatibility - returns metadata as custom_fields.

domains
industry
string | null
company_size
string | null
employee_count
integer | null
Required range: x >= 0
annual_revenue
number | null
Required range: x >= 0
phone
string | null
email
string<email> | null
website
string | null
address
string | null
city
string | null
state
string | null
country
string | null
postal_code
string | null
linkedin_url
string | null
facebook_url
string | null
instagram_url
string | null
twitter_url
string | null
twitter_handle
string | null
twitter_follower_count
integer | null
Required range: x >= 0
description
string | null
notes
string | null
logo_url
string | null
connection_strength
string | null

weak, medium, or strong

status
string | null

lead, qualified, engaged, opportunity, customer, inactive

categories
string[] | null
team_ids
ReferenceItem · object[] | null

Team members with id and name

associated_deal_ids
ReferenceItem · object[] | null

Associated deals with id and name

metadata
Metadata · object
enrichment
Enrichment · object
enrichment_provider
string | null
enrichment_last_updated
string<date-time> | null
enrichment_status
string | null
is_favorite
boolean
default:false

Whether this record is favorited by the current user