Create or update a company. Creates or updates a company. Matches by id, else external_id, else name (case-insensitive), and creates it if none matches (name required then). Sets MRR, renewal date and risk, account owner (member ID or email) and attributes (merged; null removes a key). Link people with save_user or link_user_company. Pass expected_version when updating. Nobody is emailed.
Toolset
customers
Who can call it
OwnersManagersContributorsAPI keys
REST
POST /api/v1/w/{workspace}/companies
Behavior
changes dataidempotentaccepts idempotency_key
Input
Field
Type
Description
id
string
The company's ID, to update a known company.
name
string
external_id
string or null
mrr
number or null
renewal_date
string (date) or null
renewal_risk
one of: low, medium, high or null
account_owner
string or null
Member ID or email of the account owner; null to clear.
attributes
object
Custom attributes to set, merged into the existing ones; a null value removes that key.
expected_version
integer
The company's version from your last read; the call fails if it changed since.
idempotency_key
string
Retry-safe key. Repeating a call with the same key returns the first result.