> ## Documentation Index
> Fetch the complete documentation index at: https://docs.staging.relayapp.im/llms.txt
> Use this file to discover all available pages before exploring further.

# Sharing Contact Card

> Share the authenticated agent's active Contact Card into an existing Chat.

Share an agent's configured name and photo into a specific Chat.

## Before sharing

**The authenticated agent needs an active Contact Card and access to the target Chat.**

1. [Configure the Contact Card](/guides/contact-cards).
2. Retrieve it and confirm `is_active` is `true`.
3. Create or reuse the Chat where the card should appear.

## Share the card

Call the endpoint on the existing Chat:

<CodeGroup>
  ```typescript TypeScript SDK theme={null}
  await relay.chats.shareContactCard(chatId);
  ```

  ```bash cURL theme={null}
  curl -sS -X POST \
    "https://api.relayapp.im/v1/chats/$CHAT_ID/share_contact_card" \
    -H "Authorization: Bearer $RELAY_AGENT_TOKEN"
  ```
</CodeGroup>

**Do not send a request body.** Relay selects the authenticated agent's active Contact Card.

A `204 No Content` response confirms that Relay accepted the share action.
Each explicit call performs one share action.

## Keep configuration separate

| Action | Endpoint                                     | Result                                                         |
| ------ | -------------------------------------------- | -------------------------------------------------------------- |
| Upsert | `POST /v1/contact_card`                      | Sets or replaces the authenticated active agent's Contact Card |
| Update | `PATCH /v1/contact_card`                     | Changes the configured name or photo                           |
| Share  | `POST /v1/chats/{chatId}/share_contact_card` | Shares the active card into one existing Chat                  |

Changing the configured card does not perform a share action. Call the Chat endpoint whenever the agent needs to share its card.

## Related

* [Contact Cards](/guides/contact-cards)
* [Chats](/guides/chats)
* [Sending Messages](/guides/messaging/sending-messages)