# Inbound Message

## Received

`com.twilio.messaging.inbound-message.received`

Inbound Message Received events are compatible with Webhook, Kinesis and Segment sinks. To learn more, you can get started with the [Webhook](/docs/events/webhook-quickstart), [Kinesis](/docs/events/eventstreams-quickstart) or [Segment](/docs/events/segment-quickstart) quickstarts and refer to the [product documentation](/docs/messaging/api/message-resource#message-status-values).

**Examples**

```json
{
  "specversion" : "1.0",
  "type" : "com.twilio.messaging.inbound-message.received",
  "source" : "AB00000000000000000000000001",
  "id" : "NO00000000000000000000000001",
  "dataschema" : "https://events-schemas.twilio.com/Messaging.InboundMessageV1/6",
  "datacontenttype" : "2025-10-08T07:17:02.363Z",
  "data" : {
    "messageSid" : "SM0000000000000000000000000000001",
    "timestamp" : "2025-01-01T00:00:00.000Z",
    "accountSid" : "AC0000000000000000000000000000001",
    "eventName" : "com.twilio.messaging.inbound-message.received",
    "from" : "+11234567890",
    "to" : "+12345678901",
    "numMedia" : 0,
    "body" : "Ahoy!",
    "toCountry" : "US",
    "toState" : "FL",
    "toCity" : "FORT MEADE",
    "toZip" : "33841",
    "fromCountry" : "US",
    "fromState" : "NH",
    "fromCity" : "NASHUA",
    "fromZip" : "03049",
    "mnc" : "090",
    "mcc" : "310",
    "messagingServiceSid" : "MG0000000000000000000000000000001",
    "referralCtwaClid" : "ARAkLkA8rmlFeiCktEJQ-QTwRiyYHAFDLMNDBH0CD3qpjd0HR4irJ6LEkR7JwFF4XvnO2E4Nx0-eM-GABDLOPaOdRMv-_zfUQ2a",
    "recipients" : [
      "+12345678901",
      "+15046081420"
    ],
    "optOutType" : "STOP"
  }
}
```

**Versions**

#### v6 (latest)

> \[!NOTE]
>
> v6 only contains updates to the schema metadata. In other words, there are no new fields between v5 and v6.

* `string` **messageSid** (required). Id of message which the event belongs to.
* `string` **timestamp** (required). Time of the event in ISO 8601 format.
* `string` **accountSid** (required). Id of the Twilio account which was used while sending the message.
* `string` **eventName** (required). Description of this event.
* `string` **from** (required). From number of the message.
* `string` **to** (required). To number of the message.
* `integer` **numSegments**. Number of segments.
* `integer` **numMedia**. Number of media.
* `string` **body**. Body of the message.
* `string` **toCountry**. Destination country.
* `string` **toState**. Destination state.
* `string` **toCity**. Destination city.
* `string` **toZip**. Destination zip code.
* `string` **fromCountry**. Source country.
* `string` **fromState**. Source state.
* `string` **fromCity**. Source city.
* `string` **fromZip**. Source zip code.
* `string` **mnc**. Mobile Network Code for the FROM number.
* `string` **mcc**. Mobile Country Code for the FROM number.
* `string` **messagingServiceSid**. Id of the Messaging Service.
* `string` **referralCtwaClid**. Id associated with a click to a WhatsApp advertisement, used for integrating WhatsApp message events with Meta's Conversions API.
* `string[]` **recipients**. List of recipients for Group MMS.
* `string` **optOutType**. Type of the opt-out message.

The full specification for version 6 is also available as a [JSON schema](https://events-schemas.twilio.com/Messaging.InboundMessageV1/6).

#### v5

* `string` **messageSid** (required). Id of message which the event belongs to.
* `string` **timestamp** (required). Time of the event in ISO 8601 format.
* `string` **accountSid** (required). Id of the Twilio account which was used while sending the message.
* `string` **eventName** (required). Description of this event.
* `string` **from** (required). From number of the message.
* `string` **to** (required). To number of the message.
* `integer` **numSegments**. Number of segments.
* `integer` **numMedia**. Number of media.
* `string` **body**. Body of the message.
* `string` **toCountry**. Destination country.
* `string` **toState**. Destination state.
* `string` **toCity**. Destination city.
* `string` **toZip**. Destination zip code.
* `string` **fromCountry**. Source country.
* `string` **fromState**. Source state.
* `string` **fromCity**. Source city.
* `string` **fromZip**. Source zip code.
* `string` **mnc**. Mobile Network Code for the FROM number.
* `string` **mcc**. Mobile Country Code for the FROM number.
* `string` **messagingServiceSid**. Id of the Messaging Service.
* `string` **referralCtwaClid**. Id associated with a click to a WhatsApp advertisement, used for integrating WhatsApp message events with Meta's Conversions API.
* `string[]` **recipients**. \[NEW] List of recipients for Group MMS.
* `string` **optOutType**. \[NEW] Type of the opt-out message.

The full specification for version 5 is also available as a [JSON schema](https://events-schemas.twilio.com/Messaging.InboundMessageV1/5).

#### v4

* `string` **messageSid** (required). Id of message which the event belongs to.
* `string` **timestamp** (required). Time of the event.
* `string` **accountSid** (required). Id of the Twilio account which was used while sending the message.
* `string` **eventName** (required). Description of this event.
* `string` **from** (required). From number of the message.
* `string` **to** (required). To number of the message.
* `integer` **numSegments**. Number of segments.
* `integer` **numMedia**. Number of media.
* `string` **body**. Body of the message.
* `string` **toCountry**. Destination country.
* `string` **toState**. Destination state.
* `string` **toCity**. Destination city.
* `string` **toZip**. Destination zip code.
* `string` **fromCountry**. Source country.
* `string` **fromState**. Source state.
* `string` **fromCity**. Source city.
* `string` **fromZip**. Source zip code.
* `string` **mnc**. Mobile Network Code for the FROM number.
* `string` **mcc**. Mobile Country Code for the FROM number.
* `string` **messagingServiceSid**. Id of the Messaging Service.
* `string` **referralCtwaClid**. \[NEW] Id associated with a click to a WhatsApp advertisement, used for integrating WhatsApp message events with Meta's Conversions API.

The full specification for version 4 is also available as a [JSON schema](https://events-schemas.twilio.com/Messaging.InboundMessageV1/4).

#### v3

* `string` **messageSid** (required). Id of message which the event belongs to.
* `string` **timestamp** (required). Time of the event.
* `string` **accountSid** (required). Id of the Twilio account which was used while sending the message.
* `string` **eventName** (required). Description of this event.
* `string` **from** (required). From number of the message.
* `string` **to** (required). To number of the message.
* `integer` **numSegments**. Number of segments.
* `integer` **numMedia**. Number of media.
* `string` **body**. Body of the message.
* `string` **toCountry**. Destination country.
* `string` **toState**. Destination state.
* `string` **toCity**. Destination city.
* `string` **toZip**. Destination zip code.
* `string` **fromCountry**. Source country.
* `string` **fromState**. Source state.
* `string` **fromCity**. Source city.
* `string` **fromZip**. Source zip code.
* `string` **mnc**. Mobile Network Code for the FROM number.
* `string` **mcc**. Mobile Country Code for the FROM number.
* `string` **messagingServiceSid**. \[NEW] Id of the Messaging Service.

The full specification for version 3 is also available as a [JSON schema](https://events-schemas.twilio.com/Messaging.InboundMessageV1/3).

#### v2

* `string` **messageSid** (required). Id of message which the event belongs to.
* `string` **timestamp** (required). Time of the event.
* `string` **accountSid** (required). Id of the Twilio account which was used while sending the message.
* `string` **eventName** (required). Description of this event.
* `string` **from** (required). From number of the message.
* `string` **to** (required). To number of the message.
* `integer` **numSegments**. Number of segments.
* `integer` **numMedia**. Number of media.
* `string` **body**. Body of the message.
* `string` **toCountry**. Destination country.
* `string` **toState**. Destination state.
* `string` **toCity**. Destination city.
* `string` **toZip**. Destination zip code.
* `string` **fromCountry**. Source country.
* `string` **fromState**. Source state.
* `string` **fromCity**. Source city.
* `string` **fromZip**. Source zip code.
* `string` **mnc**. \[NEW] Mobile Network Code for the FROM number.
* `string` **mcc**. \[NEW] Mobile Country Code for the FROM number.

The full specification for version 2 is also available as a [JSON schema](https://events-schemas.twilio.com/Messaging.InboundMessageV1/2).

#### v1

* `string` **messageSid** (required). Id of message which the event belongs to.
* `string` **timestamp** (required). Time of the event.
* `string` **accountSid** (required). Id of the Twilio account which was used while sending the message.
* `string` **eventName** (required). Description of this event.
* `string` **from** (required). From number of the message.
* `string` **to** (required). To number of the message.
* `integer` **numSegments**. Number of segments.
* `integer` **numMedia**. Number of media.
* `string` **body**. Body of the message.
* `string` **toCountry**. Destination country.
* `string` **toState**. Destination state.
* `string` **toCity**. Destination city.
* `string` **toZip**. Destination zip code.
* `string` **fromCountry**. Source country.
* `string` **fromState**. Source state.
* `string` **fromCity**. Source city.
* `string` **fromZip**. Source zip code.

The full specification for version 1 is also available as a [JSON schema](https://events-schemas.twilio.com/Messaging.InboundMessageV1/1).