TriggerX (Twitter)Real-timeUpdated June 2026

How do I trigger when I'm mentioned on X/Twitter?

Short answer: Drop the "X (Twitter) → New Mention" trigger on your workflow canvas, add filters if you want them, and publish. It fires within seconds of the event in X (Twitter), not on a polling schedule.

Use this trigger All 3 X (Twitter) triggers

Anatomy

What this trigger looks like in a workflow.

Drop it on the canvas. Configure a couple of fields. Publish.

In the builder

Trigger

New Mention

When the matching event happens

What this trigger returns

for the curious

You don’t need to read this. Tiny Command auto-maps every field into the visual picker so downstream nodes can pull values by clicking. We show it here for power users who want to know what’s on the wire.

{
  "data": [
    {
      "id": "1234567890",
      "text": "@myhandle check this out!",
      "author_id": "456",
      "created_at": "2026-04-20T10:00:00Z",
      "public_metrics": {
        "like_count": 1,
        "reply_count": 0,
        "retweet_count": 0
      }
    }
  ],
  "meta": {
    "newest_id": "1234567890",
    "result_count": 1
  },
  "includes": {
    "users": [
      {
        "id": "456",
        "name": "Someone",
        "username": "someone"
      }
    ]
  }
}

Output shape

Fields available to downstream nodes.

Every field below can be referenced by name in any action or filter that comes after this trigger.

Field	Type	Example
data	array	[{"id":"1234567890","text":"@myhandle check this out!","auth
meta	object	{ … }
meta.newest_id	string	"1234567890"
meta.result_count	number	1
includes	object	{ … }
includes.users	array	[{"id":"456","name":"Someone","username":"someone"}]

Pairs with

Drop these actions after New Mention.

Add Labels to Message

Gmail · Email

Add Reaction

Slack · Communication

Add Sheet Tab

Google Sheets · Spreadsheets & Databases

Create Company

HubSpot · CRM & Sales

FAQ

Questions about New Mention.

How does the New Mention trigger work in X (Twitter)?

Fires when the authenticated user is mentioned in a tweet. Polls X every 15 minutes for new mentions (X no longer offers true realtime webhooks on the standard tiers).

Is the New Mention trigger real-time?

Yes. New Mention uses webhooks or push subscriptions, not polling. Your workflow fires within seconds of the event happening in X (Twitter).

What data does New Mention return?

The full event payload from X (Twitter). The output shape table on this page lists every field, its type, and an example value so you can map fields into downstream nodes.

Can I filter New Mention so only some events start a workflow?

Yes. Add a Filter node right after the trigger and match on any field, whether that's subject, sender, status, or anything else in the payload. Workflows only continue when the filter passes.

Do I need X (Twitter) admin permissions to use New Mention?

For most X (Twitter) accounts a standard user can authorize the trigger. Some X (Twitter) plans require an admin to enable third-party webhooks. Check X (Twitter)'s docs if the trigger fails to register.