Skip to main content
Call POST /v1/chats/{chatId}/share_contact_card (reference) on an existing chat with an empty request body; the SDK method is relay.chats.shareContactCard. Relay picks the authenticated agent’s active Contact Card and shares it once. A 204 with no body confirms the share; call again to share again. Configuring the card and sharing it are separate actions. POST /v1/contact_card sets or replaces the card, PATCH /v1/contact_card changes a field, and this route shares whatever the card holds at that moment. Changing the card changes future shares, not past ones.

​
Before you start

  1. Configure the Contact Card and confirm is_active is true.
  2. Create or reuse the chat where the card should appear.

​
Share the card

Send the empty request to the chat’s share route with your Agent Token. Nothing in the body is read, so only the token, the chat, and your membership can fail. The person sees the card in the chat.

​
When it fails

​
Next steps