---
title: "Update a message"
method: PATCH
path: "/conversations/custom-channels/2026-03/{channelId}/messages/{messageId}"
tags: ["Messages"]
---

# Update a message

`PATCH /conversations/custom-channels/2026-03/{channelId}/messages/{messageId}`

Update a message's status to indicate if it was successfully sent, failed to send, or was read. For failed messages, this can also include the error message for the failure.

## Path parameters

- `channelId` integer, required
- `messageId` string, required

## Request body

- ConversationsCustomChannelsPublicChannelIntegrationMessageUpdateRequest
  - `errorMessage` string
  - `statusType` 'FAILED' | 'READ' | 'SENT', required — Valid status are SENT, FAILED, and READ

## Response `200`

successful operation

- ConversationsCustomChannelsPublicConversationsMessage
  - `archived` boolean, required
  - `attachments` union[], required
    - union
      - ConversationsCustomChannelsPublicFile
        - `fileId` string, required
        - `fileUsageType` 'AUDIO' | 'IMAGE' | 'OTHER' | 'STICKER' | 'VOICE_RECORDING', required
        - `name` string
        - `type` 'FILE', required
        - `url` string
      - ConversationsCustomChannelsPublicLocation
        - `address` string
        - `latitude` number, required
        - `longitude` number, required
        - `name` string
        - `type` 'LOCATION', required
        - `url` string
      - ConversationsCustomChannelsPublicContact
        - `contactProfile` ConversationsCustomChannelsContactProfile, required
          - `addresses` ConversationsCustomChannelsContactAddress[], required
            - `city` string
            - `country` string
            - `countryCode` string
            - `state` string
            - `street` string
            - `type` 'HOME' | 'WORK'
            - `zip` string
          - `emails` ConversationsCustomChannelsContactEmail[], required
            - `email` string, required
            - `type` 'HOME' | 'WORK'
          - `name` ConversationsCustomChannelsContactName
            - `firstName` string
            - `lastName` string
            - `middleName` string
            - `prefix` string
            - `suffix` string
          - `org` ConversationsCustomChannelsContactOrg
            - `company` string
            - `department` string
            - `title` string
          - `phones` ConversationsCustomChannelsContactPhone[], required
            - `phone` string, required
            - `type` 'CELL' | 'HOME' | 'MAIN' | 'WORK'
          - `urls` ConversationsCustomChannelsContactUrl[], required
            - `type` 'HOME' | 'WORK'
            - `url` string, required
        - `type` 'CONTACT', required
      - ConversationsCustomChannelsPublicUnsupportedContent
        - `type` 'UNSUPPORTED_CONTENT', required
      - ConversationsCustomChannelsPublicMessageHeader
        - `fileId` integer
        - `text` string
        - `type` 'MESSAGE_HEADER', required
      - ConversationsCustomChannelsPublicQuickReplies
        - `allowMultiSelect` boolean, required
        - `allowUserInput` boolean, required
        - `quickReplies` ConversationsCustomChannelsQuickReply[], required
          - `label` string
          - `value` string, required
          - `valueType` 'TEXT' | 'URL', required
        - `type` 'QUICK_REPLIES', required
      - ConversationsCustomChannelsPublicWhatsAppTemplateMetadata
        - `contentId` integer
        - `crmObjectIds` object, required
        - `mappedTemplateId` integer
        - `parameters` object, required
        - `rootMicId` integer
        - `type` 'WHATSAPP_TEMPLATE_METADATA', required
      - ConversationsCustomChannelsPublicSocialMetadataAttachment
        - `socialMetadata` ConversationsCustomChannelsSocialMetadata, required
          - `description` string
          - `id` string
          - `mediaTitle` string
          - `mediaType` 'ARTICLE' | 'AUDIO' | 'CAROUSEL' | 'DOCUMENT' | 'GIF' | 'LINK' | 'NONE' | 'PHOTO' | 'POLL' | 'STORY' | 'VIDEO', required
          - `mediaUrl` string
          - `mediaUrlString` string
          - `thumbnailUrl` string
        - `type` 'SOCIAL_MEDIA_METADATA', required
  - `channelAccountId` string, required
  - `channelId` string, required
  - `client` ConversationsCustomChannelsPublicClient, required
    - `clientType` 'HUBSPOT' | 'INTEGRATION' | 'SYSTEM' | 'UNKNOWN', required
    - `integrationAppId` integer
  - `conversationsThreadId` string, required
  - `createdAt` string, date-time, required
  - `createdBy` string, required
  - `direction` 'INCOMING' | 'OUTGOING', required
  - `id` string, required
  - `inReplyToId` string
  - `recipients` ConversationsCustomChannelsPublicRecipient[], required
    - `actorId` string
    - `deliveryIdentifier` ConversationsCustomChannelsPublicDeliveryIdentifier, required
      - `type` 'CHANNEL_SPECIFIC_OPAQUE_ID' | 'HS_EMAIL_ADDRESS' | 'HS_PHONE_NUMBER' | 'HS_SHORT_CODE', required
      - `value` string, required
    - `name` string
    - `recipientField` string
  - `richText` string
  - `senders` ConversationsCustomChannelsPublicSender[], required
    - `actorId` string
    - `deliveryIdentifier` ConversationsCustomChannelsPublicDeliveryIdentifier
      - `type` 'CHANNEL_SPECIFIC_OPAQUE_ID' | 'HS_EMAIL_ADDRESS' | 'HS_PHONE_NUMBER' | 'HS_SHORT_CODE', required
      - `value` string, required
    - `name` string
    - `senderField` string
  - `status` ConversationsCustomChannelsPublicMessageStatus
    - `failureDetails` ConversationsCustomChannelsPublicMessageFailureDetails
      - `errorMessage` string
      - `errorMessageTokens` object, required
    - `statusType` 'FAILED' | 'READ' | 'RECEIVED' | 'SENT', required
  - `subject` string
  - `text` string, required
  - `truncationStatus` 'NOT_TRUNCATED' | 'TRUNCATED' | 'TRUNCATED_TO_MOST_RECENT_REPLY', required
  - `type` 'MESSAGE', required
  - `updatedAt` string, date-time

## Other responses

- `default` — An error occurred.

---

[API](https://skmtc.net/hubspot/apis/hubspot-api-specification.md) · [All operations](https://skmtc.net/hubspot/apis/hubspot-api-specification/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hubspot/hubspot-api-specification/versions/f9c7181056c5/schema)