Inbound Message
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, Kinesis or Segment quickstarts and refer to the product documentation.
Examples
1{2"specversion" : "1.0",3"type" : "com.twilio.messaging.inbound-message.received",4"source" : "AB00000000000000000000000001",5"id" : "NO00000000000000000000000001",6"dataschema" : "https://events-schemas.twilio.com/Messaging.InboundMessageV1/8",7"datacontenttype" : "2025-10-08T07:17:02.363Z",8"data" : {9"messageSid" : "SM0000000000000000000000000000001",10"timestamp" : "2025-01-01T00:00:00.000Z",11"accountSid" : "AC0000000000000000000000000000001",12"eventName" : "com.twilio.messaging.inbound-message.received",13"from" : "+11234567890",14"to" : "+12345678901",15"numMedia" : 0,16"body" : "Ahoy!",17"toCountry" : "US",18"toState" : "FL",19"toCity" : "FORT MEADE",20"toZip" : "33841",21"fromCountry" : "US",22"fromState" : "NH",23"fromCity" : "NASHUA",24"fromZip" : "03049",25"mnc" : "090",26"mcc" : "310",27"messagingServiceSid" : "MG0000000000000000000000000000001",28"referralCtwaClid" : "ARAkLkA8rmlFeiCktEJQ-QTwRiyYHAFDLMNDBH0CD3qpjd0HR4irJ6LEkR7JwFF4XvnO2E4Nx0-eM-GABDLOPaOdRMv-_zfUQ2a",29"recipients" : [30"+12345678901",31"+15046081420"32],33"optOutType" : "STOP"34}35}
Versions
v8 (latest)
stringmessageSid (required). ID of message which the event belongs to.stringtimestamp (required). Time of the event in ISO 8601 format.stringaccountSid (required). ID of the Twilio account which was used while sending the message.stringeventName (required). Description of this event.stringfrom (required). From number of the message.stringto (required). To number of the message.integernumSegments. Number of segments.integernumMedia. Number of media.stringbody. Body of the message.stringtoCountry. Destination country.stringtoState. Destination state.stringtoCity. Destination city.stringtoZip. Destination zip code.stringfromCountry. Source country.stringfromState. Source state.stringfromCity. Source city.stringfromZip. Source zip code.stringmnc. Mobile Network Code for the FROM number.stringmcc. Mobile Country Code for the FROM number.stringmessagingServiceSid. ID of the Messaging Service.stringreferralCtwaClid. 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.stringoptOutType. Type of the opt-out message.stringexternalUserId. A unique identifier for the sender originating from an external system (e.g., a WhatsApp BSUID).stringparentExternalUserId. The unique identifier for the sender's parent entity within an external system (e.g., a WhatsApp parent BSUID).stringusername. [NEW] The user-defined profile name or alphanumeric handle associated with the sender's WhatsApp account.
The full specification for version 8 is also available as a JSON schema.
v7
stringmessageSid (required). ID of message which the event belongs to.stringtimestamp (required). Time of the event in ISO 8601 format.stringaccountSid (required). ID of the Twilio account which was used while sending the message.stringeventName (required). Description of this event.stringfrom (required). From number of the message.stringto (required). To number of the message.integernumSegments. Number of segments.integernumMedia. Number of media.stringbody. Body of the message.stringtoCountry. Destination country.stringtoState. Destination state.stringtoCity. Destination city.stringtoZip. Destination zip code.stringfromCountry. Source country.stringfromState. Source state.stringfromCity. Source city.stringfromZip. Source zip code.stringmnc. Mobile Network Code for the FROM number.stringmcc. Mobile Country Code for the FROM number.stringmessagingServiceSid. ID of the Messaging Service.stringreferralCtwaClid. 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.stringoptOutType. Type of the opt-out message.stringexternalUserId. [NEW] A unique identifier for the sender originating from an external system (e.g., a WhatsApp BSUID).stringparentExternalUserId. [NEW] The unique identifier for the sender's parent entity within an external system (e.g., a WhatsApp parent BSUID).
The full specification for version 7 is also available as a JSON schema.
v6
(information)
Info
v6 only contains updates to the schema metadata. In other words, there are no new fields between v5 and v6.
stringmessageSid (required). Id of message which the event belongs to.stringtimestamp (required). Time of the event in ISO 8601 format.stringaccountSid (required). Id of the Twilio account which was used while sending the message.stringeventName (required). Description of this event.stringfrom (required). From number of the message.stringto (required). To number of the message.integernumSegments. Number of segments.integernumMedia. Number of media.stringbody. Body of the message.stringtoCountry. Destination country.stringtoState. Destination state.stringtoCity. Destination city.stringtoZip. Destination zip code.stringfromCountry. Source country.stringfromState. Source state.stringfromCity. Source city.stringfromZip. Source zip code.stringmnc. Mobile Network Code for the FROM number.stringmcc. Mobile Country Code for the FROM number.stringmessagingServiceSid. Id of the Messaging Service.stringreferralCtwaClid. 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.stringoptOutType. Type of the opt-out message.
The full specification for version 6 is also available as a JSON schema.
v5
stringmessageSid (required). Id of message which the event belongs to.stringtimestamp (required). Time of the event in ISO 8601 format.stringaccountSid (required). Id of the Twilio account which was used while sending the message.stringeventName (required). Description of this event.stringfrom (required). From number of the message.stringto (required). To number of the message.integernumSegments. Number of segments.integernumMedia. Number of media.stringbody. Body of the message.stringtoCountry. Destination country.stringtoState. Destination state.stringtoCity. Destination city.stringtoZip. Destination zip code.stringfromCountry. Source country.stringfromState. Source state.stringfromCity. Source city.stringfromZip. Source zip code.stringmnc. Mobile Network Code for the FROM number.stringmcc. Mobile Country Code for the FROM number.stringmessagingServiceSid. Id of the Messaging Service.stringreferralCtwaClid. 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.stringoptOutType. [NEW] Type of the opt-out message.
The full specification for version 5 is also available as a JSON schema.
v4
stringmessageSid (required). Id of message which the event belongs to.stringtimestamp (required). Time of the event.stringaccountSid (required). Id of the Twilio account which was used while sending the message.stringeventName (required). Description of this event.stringfrom (required). From number of the message.stringto (required). To number of the message.integernumSegments. Number of segments.integernumMedia. Number of media.stringbody. Body of the message.stringtoCountry. Destination country.stringtoState. Destination state.stringtoCity. Destination city.stringtoZip. Destination zip code.stringfromCountry. Source country.stringfromState. Source state.stringfromCity. Source city.stringfromZip. Source zip code.stringmnc. Mobile Network Code for the FROM number.stringmcc. Mobile Country Code for the FROM number.stringmessagingServiceSid. Id of the Messaging Service.stringreferralCtwaClid. [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.
v3
stringmessageSid (required). Id of message which the event belongs to.stringtimestamp (required). Time of the event.stringaccountSid (required). Id of the Twilio account which was used while sending the message.stringeventName (required). Description of this event.stringfrom (required). From number of the message.stringto (required). To number of the message.integernumSegments. Number of segments.integernumMedia. Number of media.stringbody. Body of the message.stringtoCountry. Destination country.stringtoState. Destination state.stringtoCity. Destination city.stringtoZip. Destination zip code.stringfromCountry. Source country.stringfromState. Source state.stringfromCity. Source city.stringfromZip. Source zip code.stringmnc. Mobile Network Code for the FROM number.stringmcc. Mobile Country Code for the FROM number.stringmessagingServiceSid. [NEW] Id of the Messaging Service.
The full specification for version 3 is also available as a JSON schema.
v2
stringmessageSid (required). Id of message which the event belongs to.stringtimestamp (required). Time of the event.stringaccountSid (required). Id of the Twilio account which was used while sending the message.stringeventName (required). Description of this event.stringfrom (required). From number of the message.stringto (required). To number of the message.integernumSegments. Number of segments.integernumMedia. Number of media.stringbody. Body of the message.stringtoCountry. Destination country.stringtoState. Destination state.stringtoCity. Destination city.stringtoZip. Destination zip code.stringfromCountry. Source country.stringfromState. Source state.stringfromCity. Source city.stringfromZip. Source zip code.stringmnc. [NEW] Mobile Network Code for the FROM number.stringmcc. [NEW] Mobile Country Code for the FROM number.
The full specification for version 2 is also available as a JSON schema.
v1
stringmessageSid (required). Id of message which the event belongs to.stringtimestamp (required). Time of the event.stringaccountSid (required). Id of the Twilio account which was used while sending the message.stringeventName (required). Description of this event.stringfrom (required). From number of the message.stringto (required). To number of the message.integernumSegments. Number of segments.integernumMedia. Number of media.stringbody. Body of the message.stringtoCountry. Destination country.stringtoState. Destination state.stringtoCity. Destination city.stringtoZip. Destination zip code.stringfromCountry. Source country.stringfromState. Source state.stringfromCity. Source city.stringfromZip. Source zip code.
The full specification for version 1 is also available as a JSON schema.