---
title: "Changes to Get a message"
method: GET
path: "/conversations/v3/custom-channels/{channelId}/messages/{messageId}"
---

# Changes to Get a message

`GET /conversations/v3/custom-channels/{channelId}/messages/{messageId}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 11 of 327 revisions.

- **2026-07-13** (v3) `5cdcacfbfd17`: 1 info
- **2026-07-13** (v3) `00e6adb0221a`: 1 breaking
- **2026-05-22** (v3) `1555463e652b`: 2 info
- **2026-04-09** (v3) `6e5d9e1a7c16`: 3 info
- **2026-03-25** (v3) `ef056bda2974`: 2 info
- **2026-03-19** (v3) `c742c88dc385`: 2 info
- **2026-03-12** (v3) `7d842ac8e20c`: 2 info
- **2026-02-10** (v3) `9787358e8964`: 2 breaking, 26 warning, 2 info
- **2025-11-04** (v3) `d50d5b96b8e3`: 1 breaking, 2 info
- **2025-08-27** (v3) `49f27fdad987`: 3 breaking, 3 info
- **2024-10-23** (v3) `b5be2b51922d`: 2 info

## Changes

- **2026-07-13** (v3) `5cdcacfbfd17`: 1 info
  - endpoint added
- **2026-07-13** (v3) `00e6adb0221a`: 1 breaking
  - api path removed without deprecation
- **2026-05-22** (v3) `1555463e652b`: 2 info
  - the security scope `conversations.custom_channels.read` was added to the endpoint's security scheme `oauth2`
  - the security scope `channel-integration-read` was removed from the endpoint's security scheme `oauth2`
- **2026-04-09** (v3) `6e5d9e1a7c16`: 3 info
  - the endpoint scheme security `private_apps` was removed from the API
  - the security scope `channel-integration-read` was added to the endpoint's security scheme `oauth2`
  - the security scope `conversations.custom_channels.read` was removed from the endpoint's security scheme `oauth2`
- **2026-03-25** (v3) `ef056bda2974`: 2 info
  - api tag `Messages` added
  - api tag `Basic` removed
- **2026-03-19** (v3) `c742c88dc385`: 2 info
  - api tag `Basic` added
  - api tag `Messages` removed
- **2026-03-12** (v3) `7d842ac8e20c`: 2 info
  - api tag `Messages` added
  - api tag `External_Messages` removed
- **2026-02-10** (v3) `9787358e8964`: 2 breaking, 26 warning, 2 info
  - the response property `attachments/items/oneOf[subschema #7: WHATSAPP_TEMPLATE_METADATA]/mappedTemplateId` became optional for the status `200`
  - the `attachments/items/oneOf[subschema #7: WHATSAPP_TEMPLATE_METADATA]/mappedTemplateId` response's property type changed from `string` to `integer`, and format from no format to `int64` for status `200`
  - added the new `ARTICLE` enum value to the `attachments/items/oneOf[subschema #8: SOCIAL_MEDIA_METADATA]/socialMetadata/mediaType` response property for the response status `200`
  - added the new `AUDIO` enum value to the `attachments/items/oneOf[subschema #1: FILE]/fileUsageType` response property for the response status `200`
  - added the new `AUDIO` enum value to the `attachments/items/oneOf[subschema #8: SOCIAL_MEDIA_METADATA]/socialMetadata/mediaType` response property for the response status `200`
  - added the new `CAROUSEL` enum value to the `attachments/items/oneOf[subschema #8: SOCIAL_MEDIA_METADATA]/socialMetadata/mediaType` response property for the response status `200`
  - added the new `CHANNEL_SPECIFIC_OPAQUE_ID` enum value to the `recipients/items/deliveryIdentifier/type` response property for the response status `200`
  - added the new `CHANNEL_SPECIFIC_OPAQUE_ID` enum value to the `senders/items/deliveryIdentifier/type` response property for the response status `200`
  - added the new `DOCUMENT` enum value to the `attachments/items/oneOf[subschema #8: SOCIAL_MEDIA_METADATA]/socialMetadata/mediaType` response property for the response status `200`
  - added the new `GIF` enum value to the `attachments/items/oneOf[subschema #8: SOCIAL_MEDIA_METADATA]/socialMetadata/mediaType` response property for the response status `200`
  - added the new `HS_EMAIL_ADDRESS` enum value to the `recipients/items/deliveryIdentifier/type` response property for the response status `200`
  - added the new `HS_EMAIL_ADDRESS` enum value to the `senders/items/deliveryIdentifier/type` response property for the response status `200`
  - added the new `HS_PHONE_NUMBER` enum value to the `recipients/items/deliveryIdentifier/type` response property for the response status `200`
  - added the new `HS_PHONE_NUMBER` enum value to the `senders/items/deliveryIdentifier/type` response property for the response status `200`
  - added the new `HS_SHORT_CODE` enum value to the `recipients/items/deliveryIdentifier/type` response property for the response status `200`
  - added the new `HS_SHORT_CODE` enum value to the `senders/items/deliveryIdentifier/type` response property for the response status `200`
  - added the new `IMAGE` enum value to the `attachments/items/oneOf[subschema #1: FILE]/fileUsageType` response property for the response status `200`
  - added the new `LINK` enum value to the `attachments/items/oneOf[subschema #8: SOCIAL_MEDIA_METADATA]/socialMetadata/mediaType` response property for the response status `200`
  - added the new `NONE` enum value to the `attachments/items/oneOf[subschema #8: SOCIAL_MEDIA_METADATA]/socialMetadata/mediaType` response property for the response status `200`
  - added the new `OTHER` enum value to the `attachments/items/oneOf[subschema #1: FILE]/fileUsageType` response property for the response status `200`
  - added the new `PHOTO` enum value to the `attachments/items/oneOf[subschema #8: SOCIAL_MEDIA_METADATA]/socialMetadata/mediaType` response property for the response status `200`
  - added the new `POLL` enum value to the `attachments/items/oneOf[subschema #8: SOCIAL_MEDIA_METADATA]/socialMetadata/mediaType` response property for the response status `200`
  - added the new `STICKER` enum value to the `attachments/items/oneOf[subschema #1: FILE]/fileUsageType` response property for the response status `200`
  - added the new `STORY` enum value to the `attachments/items/oneOf[subschema #8: SOCIAL_MEDIA_METADATA]/socialMetadata/mediaType` response property for the response status `200`
  - added the new `TEXT` enum value to the `attachments/items/oneOf[subschema #6: QUICK_REPLIES]/quickReplies/items/valueType` response property for the response status `200`
  - added the new `URL` enum value to the `attachments/items/oneOf[subschema #6: QUICK_REPLIES]/quickReplies/items/valueType` response property for the response status `200`
  - added the new `VIDEO` enum value to the `attachments/items/oneOf[subschema #8: SOCIAL_MEDIA_METADATA]/socialMetadata/mediaType` response property for the response status `200`
  - added the new `VOICE_RECORDING` enum value to the `attachments/items/oneOf[subschema #1: FILE]/fileUsageType` response property for the response status `200`
  - added the optional property `attachments/items/oneOf[subschema #7: WHATSAPP_TEMPLATE_METADATA]/contentId` to the response with the `200` status
  - added the optional property `attachments/items/oneOf[subschema #7: WHATSAPP_TEMPLATE_METADATA]/rootMicId` to the response with the `200` status
- **2025-11-04** (v3) `d50d5b96b8e3`: 1 breaking, 2 info
  - for the `path` request parameter `channelId`, the type changed from `string` to `integer`, and format from no format to `int32`
  - removed the pattern `.+` from the `path` request parameter `channelId`
  - removed the pattern `.+` from the `path` request parameter `messageId`
- **2025-08-27** (v3) `49f27fdad987`: 3 breaking, 3 info
  - added the pattern `.+` to the `path` request parameter `channelId`
  - added the pattern `.+` to the `path` request parameter `messageId`
  - added `#/components/schemas/PublicSocialMetadataAttachment` to the `attachments/items/` response property `oneOf` list for the response status `200`
  - api tag `External_Messages` added
  - api tag `Messages` removed
  - for the `path` request parameter `channelId`, the type was generalized from `integer` to `string`, and format from `int32` to no format
- **2024-10-23** (v3) `b5be2b51922d`: 2 info
  - api tag `Messages` added
  - api tag `External_Messages` removed

---

[Operation](https://skmtc.dev/hubspot/apis/conversations-custom-channels/docs/conversations/v3/custom-channels/:channelId/messages/:messageId/get.md) - [API](https://skmtc.dev/hubspot/apis/conversations-custom-channels.md) - [Page](https://skmtc.dev/hubspot/apis/conversations-custom-channels/changes/conversations/v3/custom-channels/:channelId/messages/:messageId/get)
