> ## Documentation Index
> Fetch the complete documentation index at: https://hyperfx.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Twitter

> Set up and use the Twitter integration with Hyper AI

Auth type: OAuth

<Info>
  For general setup steps, permissions, and troubleshooting, start with: [App Integrations](/integrations/overview).
</Info>

## Connect Twitter

1. Go to Settings → Apps in Hyper
2. Select Twitter → Connect New
3. Complete OAuth and grant requested scopes

## Common capabilities

* Automate tweets and thread publishing
* Monitor mentions and track engagement
* Analyze social media performance

## Use in Chat

Enable Twitter in the tool selector. Ask your agent to draft tweets, check mentions, or analyze engagement.

## Use in Agents

Add Twitter to an agent's toolkits and select the connection. Require approval for publish actions.

## Use in Flows

Automate tweet scheduling, mention monitoring, and engagement workflows using Twitter action nodes.

## Troubleshooting

* Tweet not posting: verify OAuth scopes and account permissions
* Rate limits: check Twitter API rate limit status

***

## Available Actions

Hyper agents can run the following actions for this integration. Each action can be individually set to **Enabled**, **Requires Approval**, or **Disabled** in your agent's toolkit settings.

Actions can be set to one of three control states:

| State                 | Behavior                                                       |
| --------------------- | -------------------------------------------------------------- |
| **Enabled**           | Agent runs the action automatically                            |
| **Requires Approval** | Agent pauses and waits for your confirmation before proceeding |
| **Disabled**          | Action is blocked and cannot be used                           |

Configure these in the agent's toolkit settings or in workspace defaults.

| Action                  | Description                                                                                                                                      |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| Create Dm Conversation  | Create a DM conversation with participant IDs                                                                                                    |
| Follow User             | Follow a user as the authenticated user                                                                                                          |
| Get Followers           | Get followers for a user                                                                                                                         |
| Get Following           | Get users that a given user is following                                                                                                         |
| Get My Profile          | Get the authenticated user's Twitter profile including name, username, bio, location, follower/following counts, and pinned tweet                |
| Get My Reposts          | Get reposts by the authenticated user                                                                                                            |
| Get Reposts By User     | Get reposts by a given user ID                                                                                                                   |
| Get Tweet By Id         | Get a specific tweet by its ID with detailed information including author, metrics, and media                                                    |
| Like Tweet              | Like a tweet by id as the authenticated user                                                                                                     |
| Post Tweet              | Post a tweet. Optionally attach media\_ids or reply to a tweet                                                                                   |
| Repost Tweet            | Repost a tweet as the authenticated user                                                                                                         |
| Retweet                 | Retweet a tweet by id as the authenticated user                                                                                                  |
| Search Tweets           | Search recent tweets using v2 API                                                                                                                |
| Send Dm To Conversation | Send a DM by conversation ID                                                                                                                     |
| Send Dm To Participant  | Send a DM by participant ID                                                                                                                      |
| Unfollow User           | Unfollow a user as the authenticated user                                                                                                        |
| Upload Media            | Upload media (image/video) from file\_id or file\_url and return media\_id                                                                       |
| Create Dm               | Create a DM conversation with one or more participants                                                                                           |
| Follow                  | Follow a user on X                                                                                                                               |
| Get Followers           | Get followers of a user                                                                                                                          |
| Get Following           | Get users that a given user is following                                                                                                         |
| Get My Reposts          | Get reposts by the authenticated user                                                                                                            |
| Get Post                | Get a specific post by its ID with detailed information                                                                                          |
| Get Profile             | Get the authenticated user's X profile including name, username, bio, location, follower/following counts                                        |
| Get Reposts             | Get reposts by a given user ID                                                                                                                   |
| Like                    | Like a post on X by its ID                                                                                                                       |
| Post                    | Create a post on X. Optionally attach media via file\_ids (auto-uploaded), file\_paths (URLs or local paths), or media\_ids. Can reply to a post |
| Repost                  | Repost a post on X                                                                                                                               |
| Search                  | Search recent posts on X (last 7 days)                                                                                                           |
| Send Dm                 | Send a DM to a user by their ID                                                                                                                  |
| Send Dm To Conversation | Send a DM to an existing conversation                                                                                                            |
| Unfollow                | Unfollow a user on X                                                                                                                             |
| Upload Media            | Upload media (image/video) from file\_id or file\_url and return media\_id                                                                       |