# Incoming Message Notification

When a Mobile Originated (MO / Incoming) message is received, a notification will be **POSTed** to the specified webhook URL.

### Headers

| Header       | Value            |
| ------------ | ---------------- |
| Content-Type | application/json |

### Arguments

<table><thead><tr><th>Name</th><th width="131">Type</th><th>Description</th></tr></thead><tbody><tr><td>id</td><td>string</td><td>Incoming Message Id.</td></tr><tr><td>originator</td><td>string</td><td>The mobile number (MSISDN) which sent the message.</td></tr><tr><td>recipient</td><td>string</td><td>The virtual number or shortcode the message was sent to.</td></tr><tr><td>body</td><td>string</td><td>Message Text.</td></tr><tr><td>created</td><td>string</td><td>Date/Time message was received.</td></tr><tr><td>inReplyTo</td><td>string</td><td>ID of the message that this was in response to.</td></tr><tr><td>logicalMessageId</td><td>string</td><td>The Batch ID which this message is associated with.</td></tr><tr><td>ownerUserId</td><td>string</td><td>The ID of the user which received this message.</td></tr></tbody></table>

### Examples

{% tabs %}
{% tab title="Payload" %}

```json
{
   "id":"1C9A658F0A931B317B6A53BB42EC3571",
   "originator":"4400000000",
   "recipient":"12345",
   "body":"Incoming Message",
   "created":"2023-09-01T00:30:36+0000",
   "inReplyTo":"961AEAEB0A000A9D2FBD4671D07705FE",
   "logicalMessageId":"6EE262430A931B3127AFD4F044FC0622",
   "ownerUserId":"94B8CC070A000A9D2FBD467124131CA6"
}
```

{% endtab %}
{% endtabs %}
