---
title: "Update contact"
method: PATCH
path: "/whatsapp/contacts/{identifier}"
tags: ["Contacts"]
---

# Update contact

`PATCH /whatsapp/contacts/{identifier}`

Update a WhatsApp contact's profile or metadata.

## Request body

- object
  - `contact` object
    - `wa_id` string
    - `profile_name` string
    - `display_name` string
    - `customer_id` string, uuid
    - `metadata` object

## Response `200`

Contact updated

- WhatsappContactResponse
  - `data` WhatsappContact, required
    - `id` string, uuid — Unique contact ID
    - `wa_id` string, nullable — WhatsApp ID (E.164 phone number). Can be null when Meta only provides BSUID-based identity.
    - `business_scoped_user_id` string, nullable — WhatsApp business-scoped user ID
    - `parent_business_scoped_user_id` string, nullable — Parent business-scoped user ID when provided by Meta
    - `username` string, nullable — WhatsApp username when available
    - `profile_name` string — Name as shown on WhatsApp
    - `display_name` string, nullable — Custom display name set by your app
    - `customer_id` string, uuid, nullable — Associated customer ID
    - `metadata` object, nullable — Custom key-value data
    - `created_at` string, date-time
    - `updated_at` string, date-time

## Other responses

- `404` — Contact not found

---

[API](https://skmtc.net/kapso/apis/kapso-platform-api.md) · [All operations](https://skmtc.net/kapso/apis/kapso-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kapso/kapso-platform-api/revisions/18ff5548a33f/schema)