---
title: "Update a Contact"
method: PATCH
path: "/v1/contacts/{contact_id}"
tags: ["Contacts"]
---

# Update a Contact

`PATCH /v1/contacts/{contact_id}`

Updates an existing contact by its `contact_id`. Any `tags` list provided **replaces** the existing tags on the contact.

## Path parameters

- `contact_id` string, uuid, required

## Request body

- ContactUpdateRequest — Request body for updating a contact via PATCH.
  - `first_name` string, nullable — First name of the contact
  - `last_name` string, nullable — Last name of the contact
  - `email` string, nullable — Email address of the contact
  - `title` string, nullable — Job title of the contact
  - `phone_number` string, nullable — Phone number of the contact
  - `linkedin_url` string, nullable — LinkedIn profile URL
  - `location` string, nullable — Location of the contact
  - `notes` string, nullable — Notes about the contact
  - `do_not_contact` boolean, nullable — Whether the contact has opted out of outreach
  - `tags` string[], nullable — Tags for the contact

## Response `200`

Successful Response

- PublicItemResponseContactResponse
  - `data` ContactResponse, required — Contact resource. Custom fields appear as additional keys prefixed with ``custom_field_``.
    - `id` string, required — Unique identifier for the contact
    - `account_id` string, nullable — ID of the associated account
    - `first_name` string, nullable — First name of the contact
    - `last_name` string, nullable — Last name of the contact
    - `email` string, nullable — Email address of the contact
    - `title` string, nullable — Job title of the contact
    - `phone_number` string, nullable — Phone number of the contact
    - `linkedin_url` string, nullable — LinkedIn profile URL
    - `location` string, nullable — Location of the contact
    - `source` string, nullable — Source from which the contact was added
    - `do_not_contact` boolean — Whether the contact has opted out of outreach
    - `notes` string, nullable — Notes about the contact
    - `scoring` ApiPublicApiSchemasContactsScoringInfo
      - `heat_score` string, nullable — Heat score tier
    - `tags` string[] — List of tag names associated with the contact
    - `created_at` string, date-time, required — Date and time the contact was created
    - `updated_at` string, date-time, required — Date and time the contact was last updated
  - `meta` ResponseMeta
    - `timestamp` string, date-time — Server timestamp of the response

## Other responses

- `4XX` — Client error

---

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