Docs: Tool reference
customers toolset

save_company

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

FieldTypeDescription
idstringThe company's ID, to update a known company.
namestring
external_idstring or null
mrrnumber or null
renewal_datestring (date) or null
renewal_riskone of: low, medium, high or null
account_ownerstring or nullMember ID or email of the account owner; null to clear.
attributesobjectCustom attributes to set, merged into the existing ones; a null value removes that key.
expected_versionintegerThe company's version from your last read; the call fails if it changed since.
idempotency_keystringRetry-safe key. Repeating a call with the same key returns the first result.

Output

FieldTypeDescription
companyrequiredobject
createdrequiredboolean

Calling it

// MCP: tools/call
{ "name": "save_company", "arguments": {} }

// Typed client
await carechannel.save_company({});