X Poster
X Poster is the X (formerly Twitter) component that acts with your account: it publishes new posts or replies, likes and unlikes, retweets and undoes retweets, and deletes your posts.
It is useful to take to X what happens in other processes, for example to publish every new blog article automatically, or to let an AI agent handle part of your account’s activity.
When to use it
- You want to post on X every new article on your blog with a text an agent writes.
- You want to reply to a specific post from a flow.
- You want to retweet or like your own company’s posts from a department’s account.
- You need to remove a post that went out with a mistake.
Configuration
You need an X API credential with the keys of a project in the X developer portal: X API Key, X API Secret Key, X Bearer Token, X Access Token and X Access Token Secret. To post, the app must have read and write permission. See Credentials.
| Field | What it does |
|---|---|
| Credential (required) | The X API credential of the account that acts. |
| Operation (required) | What the component does. See Operations. Default: Post Tweet. |
| Mode | Only in Post Tweet. Basic publishes a new post; Advanced also shows Tweet ID so you can post a reply. Default: Basic. |
| Tweet Text | Only in Post Tweet. The text of the post. Required. |
| Tweet ID | Only in Post Tweet with Advanced. The ID of the post you want to reply to. If you leave it empty, a new post is published. |
| Tweet ID | In the other operations. The ID of the post the action applies to. It is the number at the end of its link. Required. |
| Username | Only in Like Tweet, Retweet, Unlike Tweet and Delete Retweet. The username of the credential’s account, without the @. Required. |
Operations
| Operation | What it does |
|---|---|
Post Tweet | Publishes a new post or, with Tweet ID, a reply to another post. |
Like Tweet | Likes a post. |
Retweet | Retweets a post. |
Delete Tweet | Deletes a post from the credential’s account. |
Unlike Tweet | Removes the like from a post. |
Delete Retweet | Undoes the retweet of a post. |
Output
The Tweet Data output returns X’s answer. In Post Tweet it includes the ID and text of the new post; in the other operations, a confirmation of the action, for example whether the post is now liked or retweeted.
You can connect the result to a spreadsheet to keep a log of what was posted, or to a messaging component to tell the team. The component can also be connected to an Agent as a tool. See Tool Mode.
Example
An online store announces every new blog article on X.
- The flow receives the new article’s title and link.
- An agent writes a short message with the title and the link.
- Add X Poster with the
Post Tweetoperation and the store’s X API credential. - Connect the agent’s message to Tweet Text.
- Keep the ID from the Tweet Data output in case you need to delete the post later.
Good practices
- Check the length of the text: X rejects posts that go over its character limit.
- Actions are always made with the credential’s account. To act with another account, create another credential.
Related components
- X Reader: look up posts and activity on X.