POST /2/users/:source_user_id/following
Allows a user ID to follow another user.
If the target user does not have public Tweets, this endpoint will send a follow request.
The request succeeds with no action when the source user sends a request to a user they're already following, or if they're sending a follower request to a user that does not have public Tweets.
Endpoint URL
https://api.twitter.com/2/users/:source_user_id/following
Authentication and rate limits
Authentication methods supported by this endpoint | |
---|---|
Rate limit | 50 requests per 15-minute window (user auth) |
Learn more about rate limits.
Path parameters
Name | Type | Description |
---|---|---|
source_user_id Required | string | The user ID who you would like to initiate the follow on behalf of. It must match the username of the authenticating user. |
JSON body parameters
Name | Type | Description |
---|---|---|
target_user_id Required | string | The user ID of the user that you would like the source_user_id to follow. |
Example requests
Example responses
- Successful response (public user)
- Successful response (protected user)
Response fields
Name | Type | Description |
---|---|---|
following | boolean | Indicates whether the source user is following the specified user as a result of this request. This value is false if the target user does not have public Tweets, as they will have to approve the follower request. |
pending_follow | boolean | Indicates whether the target user will need to approve the follow request. Note that the source user will follow the target user only when they approve the incoming follower request. |