> ## Documentation Index
> Fetch the complete documentation index at: https://x-preview-mintlify-sse-streaming-1775019876.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# v1 to v2
export const Button = ({href, children}) => {
return ;
};
#### Manage follows: Standard v1.1 compared to X API v2
If you have been working with the standard v1.1 [POST friendships/create](https://developer.x.com/en/docs/twitter-api/v1/accounts-and-users/follow-search-get-users/api-reference/post-friendships-create) and [POST friendships/destroy](https://developer.x.com/en/docs/twitter-api/v1/accounts-and-users/follow-search-get-users/api-reference/post-friendships-destroy) endpoints, the goal of this guide is to help you understand the similarities and differences between the standard and X API v2 manage follows endpoints.
* **Similarities**
* OAuth 1.0a User Context
* **Differences**
* Endpoint URLs
* App and Project requirements
* HTTP methods
* Request parameters
#### Similarities
**OAuth 1.0a User Context authentication method**
Both the endpoint versions support [OAuth 1.0a User Context](/resources/fundamentals/authentication#oauth-1-0a-2). Therefore, if you were previously using one of the standard v1.1 manage follows endpoints, you can continue using the same authentication method if you migrate to the X API v2 version.
#### Differences
**Endpoint URLs**
* Standard v1.1 endpoints:
* POST [https://api.x.com/1.1/friendships/create.json](https://api.x.com/1.1/friendships/create.json)
(follow a user)
* POST [https://api.x.com/1.1/friendships/destroy.json](https://api.x.com/1.1/friendships/destroy.json)
(unfollow a user)
* X API v2 endpoint:
* POST [https://api.x.com/2/users/:id/following](https://api.x.com/2/users/:id/following)
(follow a user)
* DELETE [https://api.x.com/2/users/:source\\\_user\\\_id/following/:target\\\_user\\\_id](https://api.x.com/2/users/:source\\_user\\_id/following/:target\\_user\\_id)
(unfollow a user)
**App and Project requirements**
The X API v2 endpoints require that you use credentials from a [developer App](/resources/fundamentals/developer-apps) that is associated to a [Project](/resources/fundamentals/developer-apps) when authenticating your requests. All X API v1.1 endpoints can use credentials from Apps or Apps associated with a project.
**Request parameters**
The following standard v1.1 request parameters have equivalents in X API v2:
| Standard v1.1 | X API v2 |
| :------------ | :----------------------------------- |
| No equivalent | id (POST), source\_user\_id (DELETE) |
| user\_id | target\_user\_id |
| screen\_name | No equivalent |
Please note that the Standard v1.1 parameters are passed as query parameters, whereas the X API v2 parameters are passed as body parameters (for the POST endpoint) or path parameters (for the DELETE endpoint).
Also, the v2 id and source\_user\_id are not required when using the standard v1.1 endpoints since the Access Tokens passed with OAuth 1.0a User Context inferred which user was initiating the follow/unfollow.
***
## Code examples
### Follow a user (v2)
```bash cURL theme={null}
curl -X POST "https://api.x.com/2/users/123456789/following" \
-H "Authorization: OAuth ..." \
-H "Content-Type: application/json" \
-d '{"target_user_id": "2244994945"}'
```
```python Python theme={null}
# Requires OAuth 1.0a User Context authentication
import requests
from requests_oauthlib import OAuth1
auth = OAuth1(
"API_KEY", "API_SECRET",
"ACCESS_TOKEN", "ACCESS_TOKEN_SECRET"
)
url = "https://api.x.com/2/users/123456789/following"
response = requests.post(url, auth=auth, json={"target_user_id": "2244994945"})
print(response.json())
```
```python Python SDK theme={null}
from xdk import Client
from xdk.oauth1_auth import OAuth1
oauth1 = OAuth1(
api_key="YOUR_API_KEY",
api_secret="YOUR_API_SECRET",
access_token="YOUR_ACCESS_TOKEN",
access_token_secret="YOUR_ACCESS_TOKEN_SECRET"
)
client = Client(auth=oauth1)
# Follow a user
response = client.users.follow(
source_user_id="123456789",
target_user_id="2244994945"
)
print(f"Following: {response.data.following}")
```
```javascript JavaScript SDK theme={null}
import { Client, OAuth1 } from "@xdevplatform/xdk";
const oauth1 = new OAuth1({
apiKey: "YOUR_API_KEY",
apiSecret: "YOUR_API_SECRET",
accessToken: "YOUR_ACCESS_TOKEN",
accessTokenSecret: "YOUR_ACCESS_TOKEN_SECRET",
});
const client = new Client({ oauth1 });
// Follow a user
const response = await client.users.follow("123456789", {
targetUserId: "2244994945",
});
console.log(`Following: ${response.data?.following}`);
```
### Unfollow a user (v2)
```bash cURL theme={null}
curl -X DELETE "https://api.x.com/2/users/123456789/following/2244994945" \
-H "Authorization: OAuth ..."
```
```python Python theme={null}
# Requires OAuth 1.0a User Context authentication
import requests
from requests_oauthlib import OAuth1
auth = OAuth1(
"API_KEY", "API_SECRET",
"ACCESS_TOKEN", "ACCESS_TOKEN_SECRET"
)
url = "https://api.x.com/2/users/123456789/following/2244994945"
response = requests.delete(url, auth=auth)
print(response.json())
```
```python Python SDK theme={null}
from xdk import Client
from xdk.oauth1_auth import OAuth1
oauth1 = OAuth1(
api_key="YOUR_API_KEY",
api_secret="YOUR_API_SECRET",
access_token="YOUR_ACCESS_TOKEN",
access_token_secret="YOUR_ACCESS_TOKEN_SECRET"
)
client = Client(auth=oauth1)
# Unfollow a user
response = client.users.unfollow(
source_user_id="123456789",
target_user_id="2244994945"
)
print(f"Following: {response.data.following}")
```
```javascript JavaScript SDK theme={null}
import { Client, OAuth1 } from "@xdevplatform/xdk";
const oauth1 = new OAuth1({
apiKey: "YOUR_API_KEY",
apiSecret: "YOUR_API_SECRET",
accessToken: "YOUR_ACCESS_TOKEN",
accessTokenSecret: "YOUR_ACCESS_TOKEN_SECRET",
});
const client = new Client({ oauth1 });
// Unfollow a user
const response = await client.users.unfollow("123456789", "2244994945");
console.log(`Following: ${response.data?.following}`);
```