POST account/settings

Updates the authenticating user's settings.

Resource URL

https://api.twitter.com/1.1/account/settings.json

Resource Information

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

Parameters

Name Required Description Example
sleep_time_enabled optional When set to true , t or 1 , will enable sleep time for the user. Sleep time is the time when push or SMS notifications should not be sent to the user. true
start_sleep_time optional The hour that sleep time should begin if it is enabled. The value for this parameter should be provided in ISO 8601 format (i.e. 00-23). The time is considered to be in the same timezone as the user's time_zone setting. 13
end_sleep_time optional The hour that sleep time should end if it is enabled. The value for this parameter should be provided in ISO 8601 format (i.e. 00-23). The time is considered to be in the same timezone as the user's time_zone setting. 13
time_zone optional The timezone dates and times should be displayed in for the user. The timezone must be one of the Rails TimeZone names. Europe/Copenhagen Pacific/Tongatapu
trend_location_woeid optional The Yahoo! Where On Earth ID to use as the user's default trend location. Global information is available by using 1 as the WOEID. The WOEID must be one of the locations returned by GET trends/available . 1
lang optional The language which Twitter should render in for this user. The language must be specified by the appropriate two letter ISO 639-1 representation. Currently supported languages are provided by this endpoint . it en es

Example Request

POST https://api.twitter.com/1.1/account/settings.json?lang=en

Example Response

{
  "sleep_time": {
    "end_time": null,
    "enabled": false,
    "start_time": null
  },
  "use_cookie_personalization": true,
  "trend_location": [
    {
      "name": "San Francisco",
      "placeType": {
        "name": "Town",
        "code": 7
      },
      "woeid": 2487956,
      "country": "United States",
      "url": "http://where.yahooapis.com/v1/place/2487956",
      "countryCode": "US",
      "parentid": 23424977
    }
  ],
  "language": "en",
  "discoverable_by_email": true,
  "always_use_https": true,
  "protected": false,
  "geo_enabled": true,
  "show_all_inline_media": false,
  "screen_name": "oauth_dancer"
}

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.