TriggerX (Twitter)Real-timeUpdated June 2026

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

Short answer: In TinyCommand, add the X (Twitter) New Mention trigger to a workflow and publish. It listens through a X (Twitter) webhook and fires your workflow within seconds of the event, with no polling and no code. Add a filter if you only want some events to start a run.

Trigger workflows on New Mention in X (Twitter) — start free
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. TinyCommand 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.

FieldTypeExample
dataarray[{"id":"1234567890","text":"@myhandle check this out!","auth
metaobject{ … }
meta.newest_idstring"1234567890"
meta.result_countnumber1
includesobject{ … }
includes.usersarray[{"id":"456","name":"Someone","username":"someone"}]
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.
More triggers

Other X (Twitter) triggers.

Trigger
New Post from Search
Fires when a new tweet matches your X search query. Supports keywords, hashtags, and advanced search operators. Standard for brand monitoring or campaign tracking.
Trigger
New Post from User
Fires when a specific user publishes a new tweet on X/Twitter. Use to mirror a public account into Slack, RSS, or your CMS.
Trigger workflows on New Mention in X (Twitter) — start free