PUT direct_messages/welcome_messages/update

Updates a Welcome Message by the given ID. Updates to the welcome_message object are atomic. For example, if the Welcome Message currently has quick_reply defined and you only provde text, the quick_reply object will be removed from the Welcome Message.

Resource URL


Resource Information

Response formats JSON
Requires authentication? Yes (user context only)
Rate limited? Yes


id (required) The id of the Welcome Message that should be updated.

Example request using Twurl

twurl -A 'Content-type: application/json' -X PUT '/1.1/direct_messages/welcome_messages/update.json?id=4893198399134' -d ‘
    "text": "Welcome!"

Example Response

  "name": "Generic Welcome 01"
  "welcome_message": {
    "id": "4893198399134",
    "created_timestamp": "154903045",
    "message_data": {
      "text": "Welcome!"
  "apps": {
    "8829219": {
      "id": "8829219",
      "name": "Furni",
      "url": "https://developer.twitter.com"
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.