Connect your X (Twitter) account to Goodweek to read tweets, manage posts, and interact with your timeline directly from your AI workspace.
ℹ️ Governance note
Goodweek will never exceed the access levels granted to the user within X (Twitter), guaranteeing alignment with your organization's governance policies. Outcomes and available features may vary depending on each user's specific permissions and authenticated access.
📋 Prerequisites
Before any user can see and connect the Twitter integration, your organization admin must first enable it from the Goodweek Admin Panel under the Integrations tab.
Admin Setup
The X (Twitter) integration uses OAuth 2.0 and does not require any admin-level approval before users can connect.
⚠️ X API access tier restrictions
X (Twitter) has significantly restricted its free API tier. Some features — such as reading timelines, searching tweets, or accessing analytics — may require a paid X API access tier. If certain tools are not functioning after connecting, this may be due to X API tier limitations rather than a configuration issue.
User Connection
In Goodweek, go to Integrations.
Find Twitter and click Connect.
You will be redirected to X (Twitter), where you will be asked to sign in and authorize access.
Click Authorize app to grant access and return to Goodweek.
Important Notes
Each user must connect their own account individually.
Goodweek can only access the X data that your individual user account has permission to see. Protected accounts and private content are not accessible.
Some actions may be limited by X's API rate limits regardless of the integration setup.
You can revoke Goodweek's access at any time from X → Settings → Security and account access → Apps and sessions → Connected apps → Composio → Revoke access.
Available Tools
Tool | Description | Type |
Create a Post | Creates a new Tweet on X (Twitter). | Write |
Look Up Post by ID | Retrieves detailed information for a single Tweet by its unique ID. | Write |
Get Tweets by IDs | Retrieves information for one or more Tweets by their IDs. | Write |
Search Recent Tweets | Searches Tweets from the last 7 days matching a query, using X's search syntax. | Read |
Search Full Archive of Tweets | Searches the full archive of public Tweets from March 2006 onwards. | Write |
Get User Reverse Chronological Timeline | Retrieves the home timeline (reverse chronological feed) for the authenticated user. | Read |
List Posts Timeline by List ID | Fetches the most recent Tweets posted by members of a specified Twitter List. | Read |
Like a Tweet | Likes a specific Tweet on behalf of the authenticated user. | Write |
Unlike Post | Removes a like from a specific Tweet for the authenticated user. | Write |
Retweet Post | Retweets a Tweet on behalf of the authenticated user. | Write |
Unretweet Post | Removes a retweet of a specified post by the authenticated user. | Write |
Get Post Analytics | Retrieves analytics data (engagement metrics, impressions) for specified Posts within a defined time range. | Write |
Get Post Retweeters | Retrieves users who publicly retweeted a specified Tweet. | Write |
Add Post to Bookmarks | Adds a Tweet to the authenticated user's bookmarks. | Write |
Get Bookmarks by User | Retrieves Tweets bookmarked by the authenticated user. | Read |
Look Up User by ID | Retrieves public profile information for a Twitter user by their ID. | Read |
Look Up User by Username | Retrieves public profile information for a Twitter user by their username. | Write |
Get Authenticated User | Returns profile information for the currently authenticated X user. | Write |
Get Followers by User ID | Retrieves a list of users who follow a specified Twitter user. | Read |
Get Following by User ID | Retrieves users followed by a specific Twitter user. | Read |
Follow a User | Follows another user on behalf of the authenticated user. | Read |
Unfollow User | Unfollows a user on behalf of the authenticated user. | Read |
Create a List | Creates a new, empty List on X. | Write |
Add a List Member | Adds a user to a specified Twitter List owned by the authenticated user. | Write |
Get a User's Owned Lists | Retrieves Lists created by a specific Twitter user. | Read |
Send a New Message to a User | Sends a new Direct Message with text and/or media to a specified Twitter user. | Write |
Get Recent Direct Message Events | Returns recent Direct Message events for the authenticated user. | Read |
Upload Media | Uploads images to X/Twitter using the v2 API. | Write |
Upload Large Media | Uploads a single media file (GIFs, videos, large images) to X using chunked upload. | Write |
Delete Tweet | Irreversibly deletes a specific Tweet by its ID. | ⚠️ Destructive |
Delete Direct Message | Permanently deletes a specific Twitter Direct Message event sent by the authenticated user. | ⚠️ Destructive |
Delete List | Permanently deletes a specified Twitter List owned by the authenticated user. | ⚠️ Destructive |
Use Cases
Publish posts and manage content. Create new Tweets, retweet, like, and manage content on X directly from Goodweek without opening the X app or website.
Search and monitor conversations. Search recent or historical Tweets matching a specific query — a brand name, topic, or keyword — to surface relevant conversations and content from within Goodweek.
Review post performance. Pull engagement analytics for specific Tweets to check impressions, interactions, and reach, and use that data to inform your content decisions.
Manage audience and lists. Look up user profiles, check follower lists, and manage your X Lists directly from Goodweek to keep your audience management in one place.
Troubleshooting
Some tools are not working after connecting
X (Twitter) API access is tiered and some features require a paid API plan. If tools return errors after a successful connection, the issue may be X API tier restrictions. Contact your Goodweek administrator for more information.
Integration not visible in Goodweek
Make sure your organization admin has enabled the Twitter integration from the Goodweek Admin Panel under the Integrations tab.