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 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.
name (optional) A human readable name for the Welcome Message. This is not displayed to the user. Max length of 100 alpha numeric characters including hyphens, underscores, spaces, hashes and at signs.

Note

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

Example Request

{
  "welcome_message" : {
    "name": "simple_welcome-message 01",
    "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 '{"name": "simple_welcome-message 01", "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": {
          ...
        }
      }
    }
  }
  "name": "simple_welcome-message 01"
}

Was this document helpful?

Thank you

Thank you for the feedback. We’re really glad we could help!

Thank you for the feedback. How could we improve this document?

Thank you for the feedback. Your comments will help us improve our documents in the future.