---
title: "Update a contact"
method: PUT
path: "/v2/contacts/{id}"
---

# Update a contact

`PUT /v2/contacts/{id}`

Modify an existing Contact entry by its unique identifier. Use this to sync updated user profiles, refresh address validation flags, or record changes in employment status and contact classification.

## Path parameters

- `id` string, required

## Request body

- object
  - `first_name` string, required — The contact's first name.
  - `last_name` string, required — The contact's last name.
  - `email` string, required — The contact's email address. Must be a valid email format.
  - `phone_number` string — The contact's phone number.
  - `gender` string — The contact's gender. Allowed values: `male`, `female`.
  - `shirt_size` string — The contact's preferred shirt size. Allowed values: `XS`, `SM`, `MD`, `LG`, `XL`, `2XL`, `3XL`.
  - `birthday_date` string, date — The contact's date of birth. Format: `yyyy-mm-dd` (e.g., `1990-01-15`).
  - `country` string, required — The 2-letter ISO country code (e.g., `US`, `CA`, `DE`).
  - `address` string — The primary street address. Required if `address2` is not provided.
  - `address2` string — The secondary address line (e.g., apartment, suite). Required if `address` is not provided.
  - `city` string, required — The city name.
  - `state` string, required — The state or province. For `US`: must be a valid 2-letter US state code (e.g., `NY`, `CA`, `TX`). For `CA`: must be a valid 2-letter Canadian province/territory code (e.g., `ON`, `BC`, `AB`). For other countries: any string value is accepted.
  - `zip_code` string, required — The postal/zip code.
  - `company_name` string — The name of the contact's company.
  - `department` string — The department the contact belongs to within their organization.
  - `position` string — The contact's job title or position.
  - `employee_status` string — The current employment status of the contact (e.g., active, inactive).
  - `contact_type` string, required — The type of contact. Allowed values: `employee`, `client`.
  - `employment_type` string — The type of employment (e.g., Full-Time, Part-Time, Contract).
  - `start_date` string, date — The contact's employment or engagement start date. Format: `yyyy-mm-dd` (e.g., `2024-01-15`).
  - `anniversary` string, date — The contact's wedding or work anniversary date. Format: `yyyy-mm-dd` (e.g., `2018-06-20`).
  - `client_since` string, date — The date since the contact has been a client. Format: `yyyy-mm-dd` (e.g., `2020-03-01`).
  - `contact_classification` string — A classification label for the contact (e.g., VIP, Regular).
  - `address_validated` boolean — Indicates whether the address has been validated. Accepts `true` or `false`.
  - `address_forced` boolean — Indicates whether the address was force-accepted despite validation issues. Accepts `true` or `false`.
  - `address_verified` boolean — Indicates whether the address has been verified. Accepts `true` or `false`.
  - `lists` integer[] — An array of list IDs to associate the contact with. Each ID must be a valid, existing list ID.
  - `labels` integer[] — An array of label IDs to tag the contact with. Each ID must be a valid, existing contact label ID.

## Response `200`

200

- object
  - `data` object
    - `id` integer
    - `contact_type` string
    - `first_name` string
    - `last_name` string
    - `phone` string
    - `email` string
    - `address1` string
    - `address2` string
    - `country` string
    - `city` string
    - `state` string
    - `zip_code` string
    - `company` string
    - `status` string
    - `tags` unknown
    - `created_at` string
    - `size` string
    - `gender` string
    - `department` string
    - `title` string
    - `birthday_date` string
    - `start_date` string
    - `anniversary` string
    - `client_since` string
    - `contact_classification` string
    - `provider` unknown
    - `item_external_id` unknown
    - `address_verified` boolean
    - `address_validated` boolean
    - `address_forced` boolean
    - `labels` object[]
      - `id` integer
      - `name` string
      - `description` unknown
      - `contacts_count` unknown
    - `lists` object[]
      - `id` integer
      - `name` string
    - `shipments` object[]
    - `created_by_user` object
      - `id` integer
      - `name` string
      - `first_name` string
      - `last_name` string

## Other responses

- `422` — 422

---

[API](https://skmtc.net/corporatemerch/apis/corporate-merch.md) · [All operations](https://skmtc.net/corporatemerch/apis/corporate-merch/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/corporatemerch/corporate-merch/versions/1739fae86fb3/schema)