Object: Direct Message Event

Direct Message Event objects are returned by GET direct_messages/events/list, GET direct_messages/events/show and can be consumed in real-time using the Account Activity API.

Property Description
type The type of event. Currently only message_create.
id The ID of the direct message event.
created_timestamp Epoch timestamp of when the Direct Message event was created.
initiated_via.tweet_id The ID of the Tweet with Direct Message Prompt the conversation was initiated from if one was used.
initiated_via.welcome_message_id The ID of the Welcome Message immediatley preceding the conversation if one was used.

Message Create

message_create.target.recipient_id The ID of the user receiving the message.
message_create.sender_id The ID of the user sending the message.
message_create.source_app_id The ID of the application used to create the event. App details are available in the apps object in JSON payloads containing message_create events.
message_create.message_data A message_data object.

Message Data

message_data.text The Direct Message text.
message_data.entities A Twitter entities object.
message_data.quick_reply_response A Quick Reply response object.
message_data.attachment A media or location object.

Example Direct Message Event

  "type": "message_create",
  "id": "1234858592",
  "created_timestamp": "1392078023603",
  "initiated_via": {
    "tweet_id": "123456",
    "welcome_message_id": "456789"
  "message_create": {
    "target": {
      "recipient_id": "1234858592"
    "sender_id": "3805104374",
    "source_app_id": "268278",
    "message_data": {
      "text": "Blue Bird",
      "entities": {
        "hashtags": [],
        "symbols": [],
        "urls": [],
        "user_mentions": [],
      "quick_reply_response": {
        "type": "options",
        "metadata": "external_id_2"
      "attachment": {
        "type": "media",
        "media": {