TriggerX (Twitter)Real-timeUpdated May 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.
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 curiousYou 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.
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.
TriggerNew 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.
Build a workflow on this trigger.
One trigger. 10+ downstream actions. Zero glue.
