Twitter Send Tool
Post and interact with tweets on Twitter/X.
How It Works
This skill provides instructions for the Twitter Send tool node. Connect the Twitter Send node to an AI Agent's input-tools handle to enable posting and interactions.
twitter_send Tool
Send tweets, replies, retweets, likes, and deletions.
Schema Fields
| Field | Type | Required | Description |
|---|---|---|---|
| action | string | Yes | Action type: tweet, reply, retweet, like, unlike, delete |
| text | string | If tweet/reply | Tweet text content (max 280 characters) |
| tweet_id | string | If retweet/like/unlike/delete | Target tweet ID |
| reply_to_id | string | If reply | Tweet ID to reply to |
Actions
| Action | Required Fields | Description |
|---|---|---|
tweet | text | Post a new tweet |
reply | text, reply_to_id | Reply to an existing tweet |
retweet | tweet_id | Retweet an existing tweet |
like | tweet_id | Like a tweet |
unlike | tweet_id | Remove like from a tweet |
delete | tweet_id | Delete your own tweet |
Examples
Post a tweet:
{
"action": "tweet",
"text": "Hello Twitter! This is my first automated tweet."
}
Reply to a tweet:
{
"action": "reply",
"text": "Thanks for sharing this!",
"reply_to_id": "1234567890123456789"
}
Retweet:
{
"action": "retweet",
"tweet_id": "1234567890123456789"
}
Like a tweet:
{
"action": "like",
"tweet_id": "1234567890123456789"
}
Unlike a tweet:
{
"action": "unlike",
"tweet_id": "1234567890123456789"
}
Delete a tweet:
{
"action": "delete",
"tweet_id": "1234567890123456789"
}
Response Format
{
"success": true,
"result": {
"data": {
"id": "1234567890123456789",
"text": "Hello Twitter!"
},
"action": "tweet_sent"
},
"execution_time": 0.45
}
Error Response
{
"success": false,
"error": "Tweet text is required",
"execution_time": 0.01
}
Guidelines
- Character limit: Tweets are limited to 280 characters
- Tweet IDs: Use the numeric ID string (e.g.,
1234567890123456789) - Rate limits: X API has rate limits - avoid rapid posting
- Content policy: Follow X's content policies and terms of service
- Threading: Use reply action with reply_to_id to create threads
Common Use Cases
- Post automated updates and announcements
- Reply to mentions or specific tweets
- Like tweets matching certain criteria
- Create tweet threads by chaining replies
- Engage with followers programmatically
Setup Requirements
- Connect the Twitter Send node to an AI Agent's
input-toolshandle - Ensure Twitter is connected (authenticated via OAuth in Credentials Modal)
- Your X Developer account must have appropriate API access level
