Create a new company in the current workspace.
Use this tool when the user asks to create, add, or register a new company.
REQUIRED: name
OPTIONAL: description, domain, is_company, registry_ref
Pass domain when the person gives the company's website or e-mail domain ("with the domain acme.com"): Well
stores it, so a later search of the company's mail (well_list_project_files) reads the mail sent from it.
Well treats registry search results as candidates. Pass registry_ref (the id of a
well_search_company_registry hit) only when the person picked that registry entry. Without
that pick, the company is saved by name alone and registry_match is null.
A name that is the full name of a person already held in the workspace, with no legal form,
company number or website, is refused: bill that person instead (well_define_customer with
entity_kind person). Pass is_company true only when the user says it is a company.
When the workspace already holds a live company and the person asks to create another company without its name or registration number, reply first with the name of the company they have, read from the workspace, and ask for the second company's name or registration number. Write nothing and do not search the registry until that name or number is given.
When a company_name_near_match refusal lists candidates, ask whether the person meant one and write nothing.
If yes, use that company's company_id. If no, retry with every listed company_id in distinct_from_company_ids.
After creation, enrichment (logo, domain, industry, tax ID, description fill-in)
runs asynchronously in the background. The new company is available immediately
for follow-up actions, but enriched fields may take a few seconds to populate —
re-query after a brief delay to see them.
Returns { success: true, company_id, name, registry_match } on success, or { success: false, error } on failure.