POST direct_messages/welcome_messages/new

Creates a new Welcome Message that will be stored and sent in the future from the authenticating user in defined circumstances. Returns the message template in the requested format if successful. Supports publishing with the same elements as Direct Messages (e.g. Quick Replies, media attachments).

Requires a JSON POST body and Content-Type header to be set to application/json. Setting Content-Length may also be required if it is not automatically.

See the Welcome Messages overview to learn how to work with Welcome Messages.

Resource URL

https://api.twitter.com/1.1/direct_messages/welcome_messages/new.json

Resource Information

Response formats JSON
Content-Type application/json
Requires authentication? Yes (user context only)
Rate limited? Yes

Welcome Message Object

message_data (required) The Message Data Object defining the content of the message template. See POST direct_messages/events/new (message_create) for Message Data object details.

Note

See Attaching Media to Direct Messages for details on including an image, GIF or video in Direct Messages.

Example Request

{
  "welcome_message" : {
    "message_data": {
      "text": "Welcome!",
      "attachment": {
        "type": "media",
        "media": {
          "id": "48909183894931"
        }
      }
    }
  }
}

Example request using Twurl

twurl -A 'Content-type: application/json' /1.1/direct_messages/welcome_messages/new.json -d '{"welcome_message": {"message_data": {"text": "Welcome!", "attachment": {"type": "media", "media": {"id": "48909183894931"}}}}}'

Example Response

{
  "welcome_message" : {
    "id": "844385345234",
    "created_timestamp": "1470182274821",
    "message_data": {
      "text": "Welcome!",
      "attachment": {
        "type": "media",
        "media": {
          ...
        }
      }
    }
  }
}