---
title: "Update a contact"
method: PUT
path: "/contacts/{id}"
tags: ["Contacts"]
---

# Update a contact

`PUT /contacts/{id}`

## Path parameters

- `id` number, required

## Request body

- object
  - `first_name` string, required
  - `last_name` string, required
  - `owner_id` number, required — The ID of the user that owns this contact record.
  - `company_id` number, required — The ID of the company this contact belongs to.
  - `title` string — The contact's job title.
  - `reports_to_id` number — The ID of the contact that this contact reports to.
  - `has_left_company` boolean
  - `emails` unknown[] — An array of email objects. Each email object should contain two keys: `email` and `is_primary`, as described [here](#contacts-create-an-email) ``` [ { "email": <email>, "is_primary": "<is this the primary email?>" } ] ```
    - unknown
  - `phones` unknown[] — An array of phone objects. Each phone object should contain three keys: `number`, `extension`, and `type`, as described [here](#contacts-create-a-phone) ``` [ { "number": <phone number with country code>, "extension": "<optional extension>", "type": "<phone number type>", } ] ```
    - unknown
  - `address` object — An object containing the address for the contact with the following structure: ``` { "street": "<street>", "city": "<city>", "state": "<state>", "postal_code": "<postal code>" } ```
    - `street` string
    - `city` string
    - `state` string
    - `postal_code` string
  - `country_code` string
  - `social_media_urls` unknown[]
    - unknown
  - `is_hot` boolean
  - `notes` string
  - `custom_fields` unknown[] — An array of custom field objects. Each custom field object should contain two keys: `id` and `value`. `id` is the id of a custom field definition, and `value` is the value to be set to that custom field for this contact. ``` [ { "id": <custom field definition id>, "value": "<custom field value>" } ] ```
    - unknown

## Response `204`

No Content

---

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