POST friendships/create

Allows the authenticating user to follow (friend) the user specified in the ID parameter.

Returns the followed user when successful. Returns a string describing the failure condition when unsuccessful. If the user is already friends with the user a HTTP 403 may be returned, though for performance reasons this method may also return a HTTP 200 OK message even if the follow relationship already exists.

Actions taken in this method are asynchronous. Changes will be eventually consistent.

Resource URL

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

Resource Information

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

Parameters

Name Required Description Default Value Example
screen_name optional The screen name of the user to follow.   twitterdev
user_id optional The ID of the user to follow.   12345
follow optional Enable notifications for the target user.   true

Example Request

POST https://api.twitter.com/1.1/friendships/create.json?user_id=2244994945&follow=true

Example Response

{user-object,
  "status": {tweet-object}
}