---
title: "Message event"
method: POST
path: "message"
tags: ["webhook"]
---

# Message event

`POST message` (webhook)

This event is triggered when a message is sent and/or received (according to your settings on the myringover dashboard). The data object contained in the sent object will give you information such as the sending number, the receiving number, the content of the message, the time it was sent etc...

To certify that the request was sent by Ringover, the `Authorization` header must be a base-64 encoded version of the webhook key you can find in the webhook configuration page of Ringover dashboard.

## Payload

- WebhookRequestMessage
  - `event` 'sent' | 'received'
  - `resource` string
  - `timestamp` number
  - `data` object
    - `id` string
    - `message_id` integer
    - `conversation_id` integer
    - `time` number
    - `direction` 'inbound' | 'outbound'
    - `from_number` string
    - `to_number` string
    - `body` string
    - `is_internal` boolean
    - `is_collaborative` boolean
    - `user_id` integer
  - `attempt` integer

## Acknowledgement `200`

Successful operation

## Other responses

- `default` — Other response code are ignored

---

[API](https://skmtc.net/ringover/apis/ringover-public-api.md) · [All operations](https://skmtc.net/ringover/apis/ringover-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringover/ringover-public-api/revisions/9da73dd2f99e/schema)