> ## Documentation Index
> Fetch the complete documentation index at: https://x-preview-mintlify-bdd2bb9c.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Manage Bookmarks
> This guide walks you through adding and removing bookmarks using the X API. Reference for the X API v2 standard tier covering quickstart.
export const Button = ({href, children}) => {
return ;
};
This guide walks you through adding and removing bookmarks using the X API.
**Prerequisites**
Before you begin, you'll need:
* A [developer account](https://developer.x.com/en/portal/petition/essential/basic-info) with an approved App
* User Access Token with `bookmark.write` scope (OAuth 2.0 PKCE)
***
## Add a bookmark
You need your authenticated user's ID. You can find it using the `/2/users/me` endpoint or the [user lookup endpoint](/x-api/users/lookup/introduction).
Find the Post ID in the URL when viewing a Post:
```
https://x.com/XDevelopers/status/1460323737035677698
└── This is the Post ID
```
```bash cURL theme={null}
curl -X POST "https://api.x.com/2/users/2244994945/bookmarks" \
-H "Authorization: Bearer $USER_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"tweet_id": "1460323737035677698"}'
```
```python Python SDK theme={null}
from xdk import Client
client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")
# Add a bookmark
response = client.bookmarks.create(
user_id="2244994945",
tweet_id="1460323737035677698"
)
print(f"Bookmarked: {response.data.bookmarked}")
```
```javascript JavaScript SDK theme={null}
import { Client } from "@xdevplatform/xdk";
const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });
// Add a bookmark
const response = await client.bookmarks.create("2244994945", {
tweetId: "1460323737035677698",
});
console.log(`Bookmarked: ${response.data?.bookmarked}`);
```
```json theme={null}
{
"data": {
"bookmarked": true
}
}
```
***
## Remove a bookmark
Delete a Post from your bookmarks:
```bash cURL theme={null}
curl -X DELETE "https://api.x.com/2/users/2244994945/bookmarks/1460323737035677698" \
-H "Authorization: Bearer $USER_ACCESS_TOKEN"
```
```python Python SDK theme={null}
from xdk import Client
client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")
# Remove a bookmark
response = client.bookmarks.delete(
user_id="2244994945",
tweet_id="1460323737035677698"
)
print(f"Bookmarked: {response.data.bookmarked}")
```
```javascript JavaScript SDK theme={null}
import { Client } from "@xdevplatform/xdk";
const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });
// Remove a bookmark
const response = await client.bookmarks.delete("2244994945", "1460323737035677698");
console.log(`Bookmarked: ${response.data?.bookmarked}`);
```
**Response:**
```json theme={null}
{
"data": {
"bookmarked": false
}
}
```
***
## Required scopes
When using OAuth 2.0 PKCE, your access token must have these scopes:
| Scope | Description |
| :--------------- | :----------------------- |
| `bookmark.write` | Add and remove bookmarks |
| `tweet.read` | Read Post data |
| `users.read` | Read user data |
***
## Next steps
Get your bookmarked Posts
Full endpoint documentation