• If you are citizen of an European Union member nation, you may not use this service unless you are at least 16 years old.

  • Dokkio Sidebar applies AI to make browsing the web faster and more productive. Whenever you open Sidebar, you'll get an AI summary of the web page and can ask any question you like about the content of the page! Try Dokkio Sidebar for free.


Twitter REST API Method: friendships create

Page history last edited by Marcel Molina 13 years, 3 months ago

<< Back to Twitter API Documentation



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.

method status | report a bug






xml, json


HTTP Method(s):



Requires Authentication (about authentication):



API rate limited (about rate limiting):




One of the following is required:

  • id.  Required. The ID or screen name of the user to befriend. 
    • Example: http://api.twitter.com/1/friendships/create/12345.json or http://api.twitter.com/1/friendships/create/bob.xml
  • user_id. Required. Specfies the ID of the user to befriend. Helpful for disambiguating when a valid user ID is also a valid screen name.
    • Example: http://api.twitter.com/1/friendships/create.xml?user_id=1401881

  • screen_name. Required. Specfies the screen name of the user to befriend. Helpful for disambiguating when a valid screen name is also a user ID.
    • Example: http://api.twitter.com/1/friendships/create.xml?screen_name=101010 

  • follow.  Optional. Enable delivery of statuses from this user to the authenticated user's device; tweets sent by the user being followed will be delivered to the caller of this endpoint's phone as SMSes.  See notifications/follow for more info.
    • Example:  http://api.twitter.com/1/friendships/create/bob.json?follow=true


Usage notes:


Response (about return values): 

          XML example:

<?xml version="1.0" encoding="UTF-8"?>



<name>Doug Williams</name>


<location>San Francisco, CA</location>

<description>Twitter API Support. Internet, greed, users, dougw and opportunities are my passions.</description>











<created_at>Sun Mar 18 06:42:26 +0000 2007</created_at>



<time_zone>Eastern Time (US & Canada)</time_zone>








<created_at>Tue Apr 07 22:52:51 +0000 2009</created_at>


<text>At least I can get your humor through tweets. RT @abdur: I don't mean this in a bad way, but genetically speaking your a cul-de-sac.</text>

<source><a href="http://www.tweetdeck.com/">TweetDeck</a></source>









Usage examples: 

cURL (about cURL):

curl -u user:password -d "" http://api.twitter.com/1/friendships/create/dougw.xml


          Do you have an example to share in the language of your choice? Please share!


<< Back to Twitter API Documentation

Comments (0)

You don't have permission to comment on this page.