Skip to navigation

Set a contact name

View as Markdown

Gives a contact a name, shown as the contact’s name in List contacts. The name belongs to the account, so it applies on every line.

Contacts are derived from history, but a name does not need one: you can name a number before your lines have ever talked to it, and the name appears once they do. Send name: null (or an empty string) to remove it.

Authentication

AuthorizationBearer

Your Dial API key, sent as Authorization: Bearer sk_live_...

Path parameters

numberstringRequired

The contact’s number in E.164, URL-encoded (%2B14155550123).

Request

This endpoint expects an object.
namestring or nullRequired<=100 characters
The contact's name, up to 100 characters after trimming surrounding whitespace. null or an empty string removes it.

Response

The contact's number and its name after the change.
numberstring
namestring or null

Errors

400
Bad Request Error
401
Unauthorized Error