Skip to main content
Talk to salesStart

Update company

Update standard company profile or operational fields.

PATCH/api/companies/{company_id}
HTTP referenceScope companies:writeUpdated September 27, 2026

This page documents the canonical HTTP contract for this endpoint.

The response example is abridged; the returned record can include additional fields.

Submit at least one supported field. Custom fields use the separate CRM custom-fields endpoint. Manual profile overrides remain distinct from provider firmographic refreshes.

Path parameters

  • company_idrequired

    string

    Company ID.

Body parameters

  • name · optional

    string

    Manual company name override.

  • phone · optional

    string

    Phone.

  • industry · optional

    string

    Industry.

  • primary_industry · optional

    string

    Primary industry.

  • industry_canonical · optional

    string

    Canonical industry.

  • employee_count · optional

    any

    Employee count.

  • company_size · optional

    string

    Company size.

  • location · optional

    string

    Location.

  • city · optional

    string

    City.

  • state · optional

    string

    State or region.

  • country · optional

    string

    Country.

  • zip_code · optional

    string

    Postal code.

  • timezone · optional

    string

    Timezone.

  • linkedin_url · optional

    string

    LinkedIn company URL.

  • linkedin_company_id · optional

    string

    LinkedIn company ID.

  • user_id · optional

    string

    Company owner user ID; must identify an active CRM owner in this organization.

  • account_status_override · optional

    string

    Workspace account status override: new, contacting, qualified, opportunity, nurture, customer, disqualified, competitor, vendor, or partner.

Errors

StatusMeaning
400No supported field, invalid account_status_override, or inactive/invalid owner.
401Invalid API key or missing organization context.
403Missing companies:write scope.
404Company not found.

Docs