---
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`

## Request

- Base URL: `https://api.agentphone.ai`
- URL: `https://api.agentphone.ai/v1/numbers/{number_id}/contact-card`
- Auth: HTTP bearer

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.dev/agentphone/apis/agentphone-api.md) - [All operations](https://skmtc.dev/agentphone/apis/agentphone-api/llms.txt) - [OpenAPI document](https://skmtc.dev/agentphone/apis/agentphone-api/revisions/83f12411853e?raw)