Skip to main content
PUT
Set a contact card
Save the name, photo, and note a dedicated-line agent shows as its contact. People who text that number can add it. Shared-line agents cannot set a card — one number cannot be many identities. Returns 409 dedicated_line_required. Scope: comms_send to write, comms_read to read.

Set

The number is always the agent’s dedicated line. Hosted Settings → Identity has the same editor.

Body

string
required
Dedicated-line agent.
string
Name on the card and the iMessage add-contact prompt.
string
Optional email.
string
Optional note.
string
HTTPS JPEG, PNG, or GIF, max 200KB.
string
Same image as raw base64 or a data URL.
boolean
Drop the saved photo.

Read

line_synced is true when the dedicated iMessage line accepted the name and photo for Add Contact.