POST friendships/update

Allows one to enable or disable retweets and device notifications from the specified user.

Resource URL

https://api.twitter.com/1.1/friendships/update.json

Resource Information

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

Parameters

Providing either screen_name or user_id is required.

screen_name optional

The screen name of the user for whom to befriend.

Example Values: noradio

user_id optional

The ID of the user for whom to befriend.

Example Values: 12345

device optional

Enable/disable device notifications from the target user.

Example Values: true, false

retweets optional

Enable/disable retweets from the target user.

Example Values: true, false

OAuth Signature Generator

Sign in to see a list of your registered applications.

Example Request

POST

https://api.twitter.com/1.1/friendships/update.json?user_id=1401881&device=true

Example Result

{
  "relationship": {
    "target": {
      "id_str": "1401881",
      "id": 1401881,
      "followed_by": true,
      "screen_name": "dougw",
      "following": true
    },
    "source": {
      "can_dm": true,
      "blocking": false,
      "id_str": "819797",
      "all_replies": false,
      "want_retweets": true,
      "id": 819797,
      "marked_spam": false,
      "followed_by": true,
      "notifications_enabled": true,
      "screen_name": "episod",
      "following": true
    }
  }
}