---
title: "Patch Contact"
method: PATCH
path: "/crm/contacts/{contact_id}"
tags: ["CRM Service Calls"]
---

# Patch Contact

`PATCH /crm/contacts/{contact_id}`

Update an existing contact by ID.

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

**Path Parameters:**

- **contact_id**: The contact's CRM record ID.

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

**Response:** The updated contact object.

## Path parameters

- `contact_id` string, required

## Request body

- ContactUpdateRequest
  - `name` string, nullable
  - `email` string, nullable
  - `source` string, nullable — Possible values: Google, Facebook, Youtube, Reddit, Snapchat, Craigslist, Yelp, Linkedin, Incoming-Call, SMS, Referral, Bing, Yahoo, Nextdoor, Unknown, TikTok, Instagram, Billboard Ad
  - `phone` string, nullable
  - `comments` string, nullable
  - `status` string, nullable — Possible values: open, assigned, attempted, contacted, meeting-setup, disqualified, incorrect
  - `tags` string[], nullable — List of tags (maximum 10 tags allowed)
  - `employer_name` string, nullable — Company name
  - `profession` string, nullable — Occupation
  - `title` string, nullable — Title, indexed for search
  - `ssn` string, nullable — SSN - encrypted at rest (format: XXX-XX-XXXX or XXXXXXXXX)
  - `website` string, nullable — URL, maps to vCard
  - `birth_year` integer, nullable — 4-digit year (e.g., 1985)
  - `birth_month` integer, nullable — Birth month 1-12
  - `birth_day` integer, nullable — Birth day 1-31
  - `decision_date` integer, nullable — Unix epoch timestamp (seconds)
  - `business_need_description` string, nullable — Free text for business need
  - `social_dict_list` object[], nullable — List of social profiles, e.g. [{"type": "linkedin", "url": "https://linkedin.com/in/..."}]

## Response `200`

Successful Response

- ContactResponse
  - `id` string, required
  - `phone_list` unknown[], nullable, required
    - unknown
  - `email_list` unknown[], nullable, required
    - unknown
  - `first_name` string, nullable, required
  - `last_name` string, nullable, required
  - `name` string, required
  - `status` string, required
  - `marketing_source` string, nullable
  - `created_date` string, nullable, required
  - `updated_date` string, nullable, required
  - `status_updated_date` string, nullable, required
  - `tags` string[], nullable
  - `social_dict_list` object[], 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/revisions/165a6d16a9a0/schema)