Connect Hermes to Twitter
Give your Hermes agent access to Twitter in Melso — 79 tools it can call while it works through a task.
Set it up in Melso
- 1In Melso, open Settings → Agent Apps and hit Connect on Twitter.
- 2Finish the OAUTH2 sign-in in the window that opens. Melso stores the connection, not your credentials.
- 3Open your Hermes agent, go to its Agent Apps tab, and allow Twitter.
- 4Give the agent a task. It calls Twitter itself when the work needs it.
What Twitter gives your agent
The tools, permissions, and events Twitter exposes — the same ones your agent can use once the app is authorized.
What you sign in with
Twitter connects with OAUTH2.
- Client id
- Client secret
- Application Bearer Token
Permissions
Tools Twitter exposes
Add a list member
Adds a user to a specified Twitter List; the list must be owned by the authenticated user.
Add post to bookmarks
Adds a specified, existing, and accessible Tweet to a user's bookmarks, with success indicated by the 'bookmarked' field in the response.
Append Media Upload
Append data chunk to an ongoing media upload session on X/Twitter. Use this action during chunked media uploads to append each segment of media data in sequence.
Get bookmarks by user
Retrieves Tweets bookmarked by the authenticated user, where the provided User ID must match the authenticated user's ID.
Create activity subscription
Tool to create a subscription for an X activity event. Use when you need to monitor specific user activities like profile updates, follows, or spaces events.
Create compliance job
Creates a new compliance job to check the status of Tweet or user IDs; upload IDs as a plain text file (one ID per line) to the `upload_url` received in the response.
Create group DM conversation
Creates a new group Direct Message (DM) conversation on Twitter. REQUIRED PARAMETERS: - conversation_type: Must be 'Group' - participant_ids: List of Twitter user IDs to include in the conversation - message: JSON object with the initial message. Must contain 'text' field. To include media attachments, use message.attachments array with media_id (NOT media_url): {"text": "...", "attachments": [{"media_id": "1234567890"}]} Note: Media must be uploaded first using the upload_media action to obtain a media_id.
Create a list
Creates a new, empty List on X (formerly Twitter), for which the provided name must be unique for the authenticated user; accounts are added separately.