---
title: "Update an event"
method: PUT
path: "/messaging/{connection_id}/event/{id}"
tags: ["messaging", "event"]
---

# Update an event

`PUT /messaging/{connection_id}/event/{id}`

## Request

- Base URL: `http://api.unified.to`
- URL: `http://api.unified.to/messaging/{connection_id}/event/{id}`
- Auth: API key in header `authorization`

## Path parameters

- `connection_id` string, required
- `id` string, required

## Query parameters

- `fields` string[]
- `raw` string

## Request body

- MessagingEvent
  - `id` string: not used
  - `created_at` string, date-time: (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
  - `type` 'MESSAGE_RECEIVED' | 'REACTION_ADDED' | 'REACTION_REMOVED' | 'BUTTON_CLICK' | 'APP_MENTION' | 'CHANNEL_JOINED' | 'CHANNEL_LEFT' | 'CHANNEL_CREATED' | 'CHANNEL_DELETED' | 'CHANNEL_RENAMED' | 'USER_CREATED' | 'USER_DELETED' | 'USER_UPDATED'
  - `channel` MessagingEventChannel
    - `id` string
    - `created_at` string, date-time: (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
    - `updated_at` string, date-time: (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
    - `name` string
    - `description` string
    - `parent_id` string
    - `has_subchannels` boolean
    - `members` MessagingMember[]
      - `user_id` string: (reference to HrisEmployee)
      - `email` string
      - `name` string
      - `image_url` string
    - `is_active` boolean
    - `is_private` boolean
    - `web_url` string
    - `metadata` MessagingMetadata[]
      - `id` string
      - `slug` string
      - `value` unknown
      - `namespace` string
      - `format` 'TEXT' | 'NUMBER' | 'DATE' | 'BOOLEAN' | 'FILE' | 'TEXTAREA' | 'SINGLE_SELECT' | 'MULTIPLE_SELECT' | 'MEASUREMENT' | 'PRICE' | 'YES_NO' | 'CURRENCY' | 'URL'
      - `extra_data` unknown
    - `raw` unknown
  - `message` MessagingEventMessage
    - `id` string
    - `created_at` string, date-time: (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
    - `updated_at` string, date-time: (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
    - `channels` MessagingReference[]: Represents all channels to which the message is sent. Identifies the channels where the message is posted. To send to the "Draft" channel/folder, use a channel ID "DRAFT".
      - `id` string
      - `name` string
    - `parent_id` string: Represents the ID of the immediate predecessor message in the thread. Identifies a specific message to which the current message directly replies.
    - `message_thread_identifier` string: the opaque identifier for the first message in a thread
    - `author_member` MessagingEventMessageAuthorMember: for email systems, this field represents the From value
      - `user_id` string: (reference to HrisEmployee)
      - `email` string
      - `name` string
      - `image_url` string
    - `destination_members` MessagingMember[]: for email systems, this field represents the To value
      - `user_id` string: (reference to HrisEmployee)
      - `email` string
      - `name` string
      - `image_url` string
    - `hidden_members` MessagingMember[]: for email systems, this field represents the BCC value
      - `user_id` string: (reference to HrisEmployee)
      - `email` string
      - `name` string
      - `image_url` string
    - `mentioned_members` MessagingMember[]: for email systems, this field represents the CC value
      - `user_id` string: (reference to HrisEmployee)
      - `email` string
      - `name` string
      - `image_url` string
    - `reactions` MessagingReaction[]
      - `reaction` string, required
      - `member` MessagingReactionMember, required
        - `user_id` string: (reference to HrisEmployee)
        - `email` string
        - `name` string
        - `image_url` string
    - `subject` string
    - `message` string
    - `message_html` string
    - `message_markdown` string
    - `attachments` MessagingAttachment[]
      - `filename` string
      - `size` number
      - `content_identifier` string: the inline attachment's content_id
      - `content_type` string
      - `download_url` string
      - `message_id` string
    - `web_url` string
    - `reference` string: eg. RFC822 MessageID
    - `has_children` boolean
    - `is_unread` boolean
    - `buttons` MessagingButton[]
      - `id` string, required
      - `text` string
      - `icon` string
    - `metadata` MessagingMetadata[]
      - `id` string
      - `slug` string
      - `value` unknown
      - `namespace` string
      - `format` 'TEXT' | 'NUMBER' | 'DATE' | 'BOOLEAN' | 'FILE' | 'TEXTAREA' | 'SINGLE_SELECT' | 'MULTIPLE_SELECT' | 'MEASUREMENT' | 'PRICE' | 'YES_NO' | 'CURRENCY' | 'URL'
      - `extra_data` unknown
    - `raw` unknown
  - `button` MessagingEventButton
    - `id` string, required
    - `text` string
    - `icon` string
  - `user` MessagingEventUser
    - `id` string
    - `name` string
  - `metadata` MessagingMetadata[]
    - `id` string
    - `slug` string
    - `value` unknown
    - `namespace` string
    - `format` 'TEXT' | 'NUMBER' | 'DATE' | 'BOOLEAN' | 'FILE' | 'TEXTAREA' | 'SINGLE_SELECT' | 'MULTIPLE_SELECT' | 'MEASUREMENT' | 'PRICE' | 'YES_NO' | 'CURRENCY' | 'URL'
    - `extra_data` unknown
  - `raw` unknown
  - `is_replacing_original` boolean

## Response `200`

Successful

- MessagingEvent
  - `id` string: not used
  - `created_at` string, date-time: (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
  - `type` 'MESSAGE_RECEIVED' | 'REACTION_ADDED' | 'REACTION_REMOVED' | 'BUTTON_CLICK' | 'APP_MENTION' | 'CHANNEL_JOINED' | 'CHANNEL_LEFT' | 'CHANNEL_CREATED' | 'CHANNEL_DELETED' | 'CHANNEL_RENAMED' | 'USER_CREATED' | 'USER_DELETED' | 'USER_UPDATED'
  - `channel` MessagingEventChannel
    - `id` string
    - `created_at` string, date-time: (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
    - `updated_at` string, date-time: (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
    - `name` string
    - `description` string
    - `parent_id` string
    - `has_subchannels` boolean
    - `members` MessagingMember[]
      - `user_id` string: (reference to HrisEmployee)
      - `email` string
      - `name` string
      - `image_url` string
    - `is_active` boolean
    - `is_private` boolean
    - `web_url` string
    - `metadata` MessagingMetadata[]
      - `id` string
      - `slug` string
      - `value` unknown
      - `namespace` string
      - `format` 'TEXT' | 'NUMBER' | 'DATE' | 'BOOLEAN' | 'FILE' | 'TEXTAREA' | 'SINGLE_SELECT' | 'MULTIPLE_SELECT' | 'MEASUREMENT' | 'PRICE' | 'YES_NO' | 'CURRENCY' | 'URL'
      - `extra_data` unknown
    - `raw` unknown
  - `message` MessagingEventMessage
    - `id` string
    - `created_at` string, date-time: (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
    - `updated_at` string, date-time: (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
    - `channels` MessagingReference[]: Represents all channels to which the message is sent. Identifies the channels where the message is posted. To send to the "Draft" channel/folder, use a channel ID "DRAFT".
      - `id` string
      - `name` string
    - `parent_id` string: Represents the ID of the immediate predecessor message in the thread. Identifies a specific message to which the current message directly replies.
    - `message_thread_identifier` string: the opaque identifier for the first message in a thread
    - `author_member` MessagingEventMessageAuthorMember: for email systems, this field represents the From value
      - `user_id` string: (reference to HrisEmployee)
      - `email` string
      - `name` string
      - `image_url` string
    - `destination_members` MessagingMember[]: for email systems, this field represents the To value
      - `user_id` string: (reference to HrisEmployee)
      - `email` string
      - `name` string
      - `image_url` string
    - `hidden_members` MessagingMember[]: for email systems, this field represents the BCC value
      - `user_id` string: (reference to HrisEmployee)
      - `email` string
      - `name` string
      - `image_url` string
    - `mentioned_members` MessagingMember[]: for email systems, this field represents the CC value
      - `user_id` string: (reference to HrisEmployee)
      - `email` string
      - `name` string
      - `image_url` string
    - `reactions` MessagingReaction[]
      - `reaction` string, required
      - `member` MessagingReactionMember, required
        - `user_id` string: (reference to HrisEmployee)
        - `email` string
        - `name` string
        - `image_url` string
    - `subject` string
    - `message` string
    - `message_html` string
    - `message_markdown` string
    - `attachments` MessagingAttachment[]
      - `filename` string
      - `size` number
      - `content_identifier` string: the inline attachment's content_id
      - `content_type` string
      - `download_url` string
      - `message_id` string
    - `web_url` string
    - `reference` string: eg. RFC822 MessageID
    - `has_children` boolean
    - `is_unread` boolean
    - `buttons` MessagingButton[]
      - `id` string, required
      - `text` string
      - `icon` string
    - `metadata` MessagingMetadata[]
      - `id` string
      - `slug` string
      - `value` unknown
      - `namespace` string
      - `format` 'TEXT' | 'NUMBER' | 'DATE' | 'BOOLEAN' | 'FILE' | 'TEXTAREA' | 'SINGLE_SELECT' | 'MULTIPLE_SELECT' | 'MEASUREMENT' | 'PRICE' | 'YES_NO' | 'CURRENCY' | 'URL'
      - `extra_data` unknown
    - `raw` unknown
  - `button` MessagingEventButton
    - `id` string, required
    - `text` string
    - `icon` string
  - `user` MessagingEventUser
    - `id` string
    - `name` string
  - `metadata` MessagingMetadata[]
    - `id` string
    - `slug` string
    - `value` unknown
    - `namespace` string
    - `format` 'TEXT' | 'NUMBER' | 'DATE' | 'BOOLEAN' | 'FILE' | 'TEXTAREA' | 'SINGLE_SELECT' | 'MULTIPLE_SELECT' | 'MEASUREMENT' | 'PRICE' | 'YES_NO' | 'CURRENCY' | 'URL'
    - `extra_data` unknown
  - `raw` unknown
  - `is_replacing_original` boolean

---

[API](https://skmtc.dev/unified/apis/unified-to-api-2.md) · [All operations](https://skmtc.dev/unified/apis/unified-to-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/unified/apis/unified-to-api-2/revisions/7a38bdd7f089?raw)