Skip to main content
Auth. HMAC v1 or bearer token — see Authentication. Status. Live · Idempotent: No (sends a fresh handshake each call).
Shares the line’s saved contact card — the operator’s “Me” card on the device tied to the pinned line. This lets the recipient save your line as a contact and can surface the line’s display name in Messages. For sharing another person’s contact details, use send-contact; it is the more predictable vCard flow.

Addressing the recipient

Request

POST /api/v1/chats/{id}/share-contact-info

Response

Path parameters

string
Chat identifier (ch_…). The chat must have a pinned line. Omit and use body.to for first-touch recipients.

Body

string
Recipient phone in E.164 format. Use instead of the {id} path segment when no chat exists yet. Ignored when {id} is supplied.

Response fields

string
The chat the line’s “Me” card was shared into.
string
Always "shared" on success.

Errors

See the full error code reference.

See also