---
title: "Create contact"
method: POST
path: "/whatsapp/contacts"
tags: ["Contacts"]
---

# Create contact

`POST /whatsapp/contacts`

Create a new WhatsApp contact.

## Request body

- object
  - `contact` object, required
    - `wa_id` string, required — WhatsApp ID (phone number in E.164 format)
    - `profile_name` string
    - `display_name` string
    - `customer_id` string, uuid
    - `metadata` object

## Response `201`

Contact created

- 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

- `422` — Validation error

---

[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)