---
title: "Patch Account"
method: PATCH
path: "/crm/accounts/{account_id}"
tags: ["CRM Service Calls"]
---

# Patch Account

`PATCH /crm/accounts/{account_id}`

Update an existing account by ID.

Send only the fields you want to change. Returns 400 if no fields are provided.

**Path Parameters:**

- **account_id**: The account's CRM record ID.

**Request Body (AccountUpdateRequest):** Same fields as POST /accounts, but all optional.

**Response:** The updated account object.

## Path parameters

- `account_id` string, required

## Request body

- AccountUpdateRequest — Request to update an existing account.
  - `name` string, nullable
  - `email` string, nullable
  - `phone` string, nullable
  - `source` string, nullable — Marketing source, e.g. Google, Facebook, Referral, Unknown
  - `status` string, nullable — Possible values: open, assigned, attempted, contacted, meeting-setup, customer, lost-followup, lost, inactive, incorrect, disqualified, prospect, ex-customer
  - `relationship_type` 'customer' | 'vendor' | 'partner' | 'prospect' | 'other', nullable — Possible values: customer, vendor, partner, prospect, other
  - `tags` string[], nullable — List of tags (maximum 10 tags allowed)
  - `website` string, nullable — Company website URL
  - `company_name` string, nullable — Company display name
  - `description` string, nullable — Account description / notes
  - `industry` string, nullable — Industry sector, e.g. technology, healthcare, other
  - `num_employees` integer, nullable — Number of employees
  - `social_dict_list` object[], nullable — List of social profiles, e.g. [{"type": "linkedin", "url": "https://linkedin.com/company/..."}]

## Response `200`

Successful Response

- AccountResponse
  - `id` string, required
  - `name` string, required
  - `phone_list` unknown[], nullable
    - unknown
  - `email_list` unknown[], nullable
    - unknown
  - `status` string, nullable
  - `source` string, nullable
  - `relationship_type` string, nullable
  - `website` string, nullable
  - `company_name` string, nullable
  - `description` string, nullable
  - `industry` string, nullable
  - `num_employees` integer, nullable
  - `tags` string[], nullable
  - `social_dict_list` object[], nullable
  - `created_date` string, nullable
  - `updated_date` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/ambivo/apis/ambivo-api.md) · [All operations](https://skmtc.net/ambivo/apis/ambivo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ambivo/ambivo-api/versions/165a6d16a9a0/schema)