# How to Attach a Link

## Add a Link When Sending a Message

Include link attachments directly when creating a text message using the v5 API.

```
POST /v5/messages/text
Content-Type: application/json
```

```json
{
  "conversation_id": "<conversation_id from webhook>",
  "transcript": "Check out this link",
  "reply_to_message_id": "<id from webhook>",
  "attachments": [
    {
      "type": "link",
      "link": "https://example.com"
    }
  ]
}
```

## Attach a Link to an Existing Message

Add a URL link attachment to an existing message. You can include multiple links in one request.

```
POST /messages/{message_id}/attachments
Content-Type: application/json
```

```json
{
  "attachments": [
    {
      "type": "link",
      "link": "https://example.com"
    }
  ]
}
```

The `message_id` is returned in the response from [`POST /v5/messages/text`](./how-to-send-a-message.md).