# Update a client

Required scopes: client:write

To update external_id jump to Endpoint /clients/{id}/external-identifier
 To update shortcode jump to Endpoint /clients/{id}/shortcode

Endpoint: PATCH /clients/{id}
Version: v1
Security: http, oauth2

## Path parameters:

  - `id` (string, required)

## Query parameters:

  - `find_by` (string)
    The field to search by
    Enum: "id", "external_id", "shortcode"

  - `origin` (string)
    Used if find_by=external_id by default it will use the integration slug

## Request fields (application/json):

  - `name` (string)

  - `segment` (string)
    Enum: "A", "B", "C"

  - `primary_contact_id` (string,null)
    User ID of the account manager

## Response 200 fields (application/json):

  - `id` (string, required)

  - `external_id` (string,null, required)
    Can be used to add an identifier to the client from an external system, must be unique

  - `external_origin` (string,null, required)
    If originated from external system origin is added

  - `name` (string, required)

  - `shortcode` (string,null, required)

  - `primary_contact` (any, required)

  - `origin_space` (any, required)

## Response 401 fields (application/json):

  - `message` (string, required)
    Error overview.

## Response 422 fields (application/json):

  - `message` (string, required)
    Errors overview.

  - `errors` (object, required)
    A detailed description of each field that failed validation.