← All toolsCommunicationsocial_mediaAll editions

POST_TWEET

Post a single tweet or a multi-part threaded tweet to Twitter/X. To post a thread, provide an array of strings under the 'texts' parameter, ordered from first tweet to last string. Each text string must be under 280 characters.

Parameters

NameTypeRequiredDescription
textsarrayyesList of strings to tweet. Single item for a regular tweet. Multiple items for a thread.

How to use it

You normally trigger this by describing what you want in chat — the agent selects POST_TWEET automatically. For example:

Try saying
“use social media to post …”

In a workflow

As a step in a multi-step workflow DAG:

json
{
  "id": "s1",
  "agent": "social_media",
  "action": "POST_TWEET",
  "args": {
    "texts": []
  },
  "depends_on": [],
  "outputs": []
}

Direct call

For scripting, call it directly via POST /execute_tool. Every tool returns { success, message, data }.

bash
curl -X POST http://127.0.0.1:8000/execute_tool \
  -H "Content-Type: application/json" \
  -d '{"tool_name":"POST_TWEET","args":{"texts":[]}}'

Part of the social_media plugin. Browse the full Plugin & Tool Catalog or the relevant feature guide.