X API can share Community posts with followers via share_with_followers
What changed
On July 28, 2025 X added an optional share_with_followers boolean to POST /2/tweets. Sent with a community_id and set to true, it also broadcasts the Community post to the authenticated user's followers' timelines, matching the Also share with followers checkbox on x.com. This builds on the community_id Post field X added to API v2 on November 22, 2024.
What it means
Scheduling tools that publish to X Communities can also put the post in the author's followers' timelines, matching the checkbox on x.com.
Who is affected
Scheduling and publishing tools that post to X Communities with POST /2/tweets.
What to do by 28 Jul 2025
When creating a Community post, send community_id with share_with_followers set to true to also broadcast it to followers. Read the community_id Post field to see which Community a post belongs to.
What this means for you
Communities on X are groups built around a topic. When you post in one, only the group usually sees it. On x.com you can tick a box to show it to your followers too. Apps that post for you can now do the same, so a scheduled Community post can reach both the group and your followers.
The details
- New parameter (July 28, 2025):
share_with_followers(boolean, optional) onPOST /2/tweets. Withcommunity_idset andshare_with_followers: true, the Community post is also broadcast to the authenticated user's followers' timelines. - Related field (November 22, 2024): X added the
community_idPost field to API v2. The Create or Edit Post reference describescommunity_idin the request body as the "Community to post the tweet to" (numeric ID, up to 19 digits). - Doc mismatch: the Create or Edit Post schema currently describes
share_with_followersas "Share an exclusive (super-follower) tweet with all followers", which differs from the changelog. Test both cases before relying on either reading.
What to do next
- Business owners: Nothing.
- Marketers and agencies: If you post to X Communities, ask your scheduler whether it supports sharing those posts with followers.
- Developers: Add a share-with-followers option next to
community_idin your post composer and sendshare_with_followers: truewhen it is ticked.
Primary sources
- X Developer Platform: Changelog (Jul 28, 2025)
- X Developer Platform: Changelog (Nov 22, 2024)
- X Developer Platform: Create or Edit Post
Get an email when a new API change is added
Follow new entries with the RSS feed. Each platform also has its own feed, for example X or Meta.