friendships/create

Allows the authenticating users to follow the user specified in the ID parameter. Returns the befriended user in the requested format when successful. Returns a string describing the failure condition when unsuccessful. If you are already friends with the user an HTTP 403 will be returned.

URL: http://twitter.com/friendships/create.{{response_format}}

API rate limited: false

HTTP Method:

• POST

Response Format:

• json
• xml

Authenticate Request:

• Yes

One of the following parameters is required:

• user_id:

  Specfies the ID of the user to befriend.

• screen_name:

  Specfies the screen name of the user to befriend.

Optional Parameters:

• follow:

  Enable (set to 'true') notifications for the target user in addition to becoming friends.

Notes: Show

• You can also use the (ambiguous) parameter - id. The ID or screen name of the user to befriend. (Example: http://twitter.com/friendships/create/12345.json or http://twitter.com/friendships/create/bob.xml)

* You need to Sign in with Twitter first to make authenticated request.