Twitter API v2
  • General
  • Spaces
  • Tweets
  • Users
    • Returns user objects that have liked the provided Tweet IDGET
    • Returns user objects that have retweeted the provided Tweet IDGET
    • User lookup by IDsGET
    • User lookup by usernamesGET
    • User lookup by usernameGET
    • User lookup by IDGET
    • Returns user objects that are blocked by provided user IDGET
    • Block User by User IDPOST
    • Returns user objects that follow the provided user IDGET
    • Following by User IDGET
    • Follow UserPOST
    • Mute User by User IDPOST
    • Unblock User by User IDDELETE
    • Unfollow UserDELETE
    • Unmute User by User IDDELETE
logoPowered by Apidog
  1. Users

Follow User

POST/2/users/{id}/following

Causes the user(in the path) to follow, or “request to follow” for protected users, the target user. The user(in the path) must match the user context authorizing the request

Request

Path Params
id
string 
required

The ID of the user that is requesting to follow the target user

Body Params application/json
target_user_id
string 
required
Match pattern:
^[0-9]{1,19}$
Example
{
  "target_user_id": "string"
}

Request samples

Responses

The request was successful(200)
500(500)
The request was successful
HTTP Code: 200
Content Type : JSONapplication/json
Data Schema
data
object 
optional
following
boolean 
optional
pending_follow
boolean 
optional
errors
array[null (Problem) {17}] 
optional
>= 1 items
object 
GenericProblem
optional

A generic problem with no additional information beyond that provided by the HTTP status code.

object 
InvalidRequestProblem
optional

A problem that indicates this request is invalid.

object 
ClientForbiddenProblem
optional

A problem that indicates your client is forbidden from making this request.

object 
ResourceNotFoundProblem
optional

A problem that indicates that a given Tweet, User, etc. does not exist.

object 
ResourceUnavailableProblem
optional

A problem that indicates a particular Tweet, User, etc. is not available to you.

object 
ResourceUnauthorizedProblem
optional

A problem that indicates you are not allowed to see a particular Tweet, User, etc.

object 
FieldUnauthorizedProblem
optional

A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.

object 
DisallowedResourceProblem
optional

A problem that indicates that the resource requested violates the precepts of this API.

object 
UnsupportedAuthenticationProblem
optional

A problem that indicates that the authentication used is not supported.

object 
UsageCapExceededProblem
optional

A problem that indicates that a usage cap has been exceeded.

object 
ConnectionExceptionProblem
optional

A problem that indicates something is wrong with the connection

object 
ClientDisconnectedProblem
optional

Your client has gone away.

object 
OperationalDisconnectProblem
optional

You have been disconnected for operational reasons.

object 
RulesCapProblem
optional

You have exceeded the maximum number of rules.

object 
InvalidRuleProblem
optional

The rule you have submitted is invalid.

object 
DuplicateRuleProblem
optional

The rule you have submitted is a duplicate.

object 
ConflictProblem
optional

You cannot create a new job if one is already in progress.

Example
Not configured
Last modified: 2 years ago