---
title: "Put Contact Card"
method: PUT
path: "/v1/numbers/{number_id}/contact-card"
tags: ["contact cards"]
---

# Put Contact Card

`PUT /v1/numbers/{number_id}/contact-card`

Create or replace the iMessage contact card on this number.

## Path parameters

- `number_id` string, required

## Request body

- ContactCardWriteRequest
  - `firstName` string, nullable
  - `lastName` string, nullable
  - `displayName` string, nullable
  - `avatarUrl` string, nullable

## Response `200`

Successful Response

- ContactCardResponse
  - `firstName` string, nullable
  - `lastName` string, nullable
  - `displayName` string, nullable
  - `hasAvatar` boolean

## Other responses

- `422` — Validation Error

---

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