Connect Twitter with Hookshot™ and your stack

Twitter, Inc. was an American social media company based in San Francisco, California, which operated and was named for named for its flagship social media network prior to its rebrand as X.

Browse integrations Visit website

Tools and triggers

What Agents can do in Twitter

Available tools and events after Twitter is connected.

  • 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.

  • 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.

  • Create a Post

    Creates a Tweet on Twitter; `text` is required unless `card_uri`, `media_media_ids`, `poll_options`, or `quote_tweet_id` is provided. Example - Creating a tweet with media and location: { "text": "Check out our latest…

  • 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…

  • Delete Direct Message

    Permanently deletes a specific Twitter Direct Message (DM) event using its `event_id` if the authenticated user sent it; this action is irreversible and does not delete entire conversations.

  • Delete List

    Permanently deletes a specified Twitter List using its ID, which must be owned by the authenticated user; this action is irreversible and the list must already exist.

  • Delete Tweet

    Irreversibly deletes a specific Tweet by its ID; the Tweet may persist in third-party caches after deletion.

  • Fetch List Members by Id

    Fetches members of a specific Twitter List, identified by its unique ID.

  • Fetch OpenAPI Specification

    Fetches the OpenAPI specification (JSON) for Twitter's API v2, used to programmatically understand the API's structure for developing client libraries or tools.

  • Fetch Recent Tweet Counts

    Retrieves the count of Tweets matching a specified search query within the last 7 days, aggregated by 'minute', 'hour', or 'day'.

  • Fetch Space Ticket Buyers List

    Retrieves a list of users who purchased tickets for a specific, valid, and ticketed Twitter Space.

  • Fetch Tweet Usage Data

    Fetches Tweet usage statistics for a Project (e.g., consumption, caps, daily breakdowns for Project & Client Apps) to monitor API limits; data can be retrieved for 1 to 90 days.

  • Follow a List

    Allows the authenticated user (`id`) to follow a specific Twitter List (`list_id`) they are permitted to access, subscribing them to the list's timeline; this does not automatically follow individual list members.

  • Follow a User

    Allows an authenticated user (path `id`) to follow another user (`target_user_id`), which results in a pending request if the target user's tweets are protected.

  • Get a User's List Memberships

    Retrieves all Twitter Lists a specified user is a member of, including public Lists and private Lists the authenticated user is authorized to view.

  • Get a User's Owned Lists

    Call this action to retrieve Lists created (owned) by a specific Twitter user, not Lists they follow or are subscribed to.

  • Get a User's Pinned Lists

    Retrieves the Lists a specific, existing Twitter user has pinned to their profile to highlight them.

  • Get Authenticated User

    Returns profile information for the currently authenticated X user, customizable via request fields.

  • Get Bookmarks by User

    Retrieves Tweets bookmarked by the authenticated user, where the provided User ID must match the authenticated user's ID.

  • Get DM Events by ID

    Fetches a specific Direct Message (DM) event by its unique ID, allowing optional expansion of related data like users or tweets; ensure the `event_id` refers to an existing DM event accessible to the authenticated user.

Setup

Connect Twitter in Hookshot™

Pick a scope, then confirm what can start a Protege and what it can do.

Trigger Access

What can start a Protege from this app.

Tool Access

What a Protege can do after it starts.

Connection scope

Prefer team for production.

Team

Shared credential for production and unattended runs.

Personal

Tied to one user—only when the workflow needs their account.

Chat

Team-scoped for supported chat surfaces.

Full setup guide

Build with us

See Hookshot™ in your stack.

Request early access or book a live walkthrough with the team.

Request Demo
Hookshot™ setup screen — AI agent workflow configuration with model selection, trigger status, and governance controls.