---
title: "PATCH /crm/companies/{id}"
method: PATCH
path: "/crm/companies/{id}"
tags: ["CRM Companies"]
---

# PATCH /crm/companies/{id}

`PATCH /crm/companies/{id}`

## Request

- Base URL: `https://developer.meetergo.com` (the document declares no server; this is the origin it was published from)
- URL: `https://developer.meetergo.com/crm/companies/{id}`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer
  - API key in header `x-meetergo-api-user-id`

## Path parameters

- `id` string, required

## Request body

- UpdateCrmCompanyDto
  - `name` string
  - `domain` string
  - `industry` string
  - `size` '1-10' | '11-50' | '51-200' | '201-500' | '501-1000' | '1001+'
  - `website` string
  - `phoneNumber` string
  - `addressLine1` string
  - `addressLine2` string
  - `addressCity` string
  - `addressZip` string
  - `addressCountry` string
  - `notes` string
  - `ownerId` string
  - `customFields` object: Values for the company custom fields configured under `GET /crm/settings/custom-fields?recordType=company`, keyed by field key. On update this is a patch: keys you do not send are left alone, and a key sent as `null` is removed.

## Response `200`

- CrmCompanyDto
  - `id` string, required
  - `name` string, required
  - `domain` string
  - `industry` string
  - `size` '1-10' | '11-50' | '51-200' | '201-500' | '501-1000' | '1001+'
  - `website` string
  - `iconUrl` string: Cached brand mark, so lists can anchor on the company's own logo.
  - `phoneNumber` string
  - `address` object
    - `line1` string
    - `line2` string
    - `line3` string
    - `city` string
    - `zip` string
    - `country` string
  - `notes` string
  - `description` string: What the company publishes about itself. Never the seller's own `notes`.
  - `ownerId` string
  - `companyId` string, required
  - `customFields` object
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required
  - `owner` object
    - `id` string, required
    - `givenName` string
    - `familyName` string
    - `email` string, required
  - `contactsCount` number
  - `dealsCount` number
  - `totalDealsValue` number
  - `totalDealsCurrency` string: Majority deal currency behind `totalDealsValue`. Additive: older clients ignore it and keep their display fallback.

## Other responses

- `400`: The request did not validate. `message` lists the constraints that failed.
- `401`: Missing, malformed, or expired credentials.
- `403`: Authenticated, but not allowed: the plan does not include this feature, or the token is scoped away from it.
- `404`: No such resource in your account. Resources belonging to another account are reported the same way.
- `429`: Rate limited. Back off and retry.

---

[API](https://skmtc.dev/meetergo/apis/meetergo-platform-api.md) · [All operations](https://skmtc.dev/meetergo/apis/meetergo-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/meetergo/apis/meetergo-platform-api/revisions/b5d66cd8be67?raw)
