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

For a sample of the JSON returned (and the full set of fields) for this endpoint, please see the GET account/settings page.

While all parameters for this method are optional, at least one or more should be provided when executing this request.

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.

Example Values: 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 ISO8601 format (i.e. 00-23). The time is considered to be in the same timezone as the user’s time_zone setting.

Example Values: 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 ISO8601 format (i.e. 00-23). The time is considered to be in the same timezone as the user’s time_zone setting.

Example Values: 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.

Example Values: 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 [node:59].

Example Values: 1

allow_contributor_request optional

Whether to allow others to include user as contributor. Possible values include “all” (anyone can include user), “following” (only followers can include user) or “none”.

Also note that changes to this field require the request also include a “current_password” value with the user’s password to successfully modify this field.

Example Values: 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.

Example Values: it, en, es

OAuth Signature Generator

Sign in to see a list of your registered applications.

Example Request

POST

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

Example Result

{
  "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"
}