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

FormUse when
POST /api/v1/chats/{id}/share-contact-infoA chat already exists for this recipient.
POST /api/v1/chats/share-contact-info with { "to": "+1..." } bodyFirst-touch — no chat yet. Chert resolves or creates the chat in-line.

​
Request

POST /api/v1/chats/{id}/share-contact-info 
curl -X POST https://console.trychert.com/api/v1/chats/ch_01H.../share-contact-info \
  -H "x-chert-tenant: $TENANT" \
  -H "x-chert-signature: v1,$TS,$SIG"

​
Response

{
  "chat_id": "ch_01H...",
  "status": "shared"
}

​
Path parameters

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

​
Body

​
to
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

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

​
Errors

CodeHTTPWhen
1002400Chat has no recipient phone.
2002404Chat not found.
4001502Delivery failed.
4099501No pinned line, or the line does not support contact sharing.
See the full error code reference.

​
See also