App Logo
x.com

Pin tweet to profile

Pin one of your own tweets to the top of your profile, given its URL. Already-pinned tweets are reported rather than re-pinned. Pinning a new tweet replaces whatever was previously pinned. Returns tweet_id, pinned, was_pinned, and account_used. X can briefly serve a stale pinned-state right after a preceding pin/unpin on the account — if you just changed the pin state, allow a few seconds before calling this again for a reliable was_pinned reading.

Input

tweet_url required

Full URL of your tweet to pin, e.g. https://x.com/handle/status/123.

Output

pinned required
tweet_id required
was_pinned required

true if the tweet was already pinned before this call — no action was taken.

account_used optional

handle of the logged-in account that performed the action, read from the account switcher UI.

Start building not clicking