Manage Bookmarks

Add and remove bookmarks using the X API

This guide walks you through adding and removing bookmarks using the X API.

Prerequisites

Before you begin, you’ll need:

• A developer account with an approved App
• User Access Token with bookmark.write scope (OAuth 2.0 PKCE)

---

Add a bookmark

1. Get your user ID

   You need your authenticated user’s ID. You can find it using the /2/users/me endpoint or the user lookup endpoint.

2. Get the Post ID

   Find the Post ID in the URL when viewing a Post:

   https://x.com/XDevelopers/status/1460323737035677698
                                   └── This is the Post ID
   
3. Add the bookmark

   cURL

   shellscript

   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"}'
   
4. Review the response

   {
     "data": {
       "bookmarked": true
     }
   }
   

---

Remove a bookmark

Delete a Post from your bookmarks:

cURL

shellscript

curl -X DELETE "https://api.x.com/2/users/2244994945/bookmarks/1460323737035677698" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

Response:

{
  "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

Bookmarks lookup

Get your bookmarked Posts

API Reference

Full endpoint documentation