You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: developer-guidelines.mdx
+33-39Lines changed: 33 additions & 39 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -59,66 +59,60 @@ Before building, ask yourself these questions. If you answer **"no"** to any of
59
59
60
60
## Common Scenarios: Allowed or Not?
61
61
62
-
Real-world examples to help you understand what's permitted. These cover automated accounts, integrations, and apps of all types.
62
+
Real-world examples to help you understand what's permitted. **These rules apply to all apps**—whether you're building a bot, mobile app, web integration, browser extension, analytics dashboard, or any other tool that uses the X API.
| App responds to @mentions asking for help | <Iconicon="circle-check"color="#22c55e" /> | User-initiated request |
81
+
| App auto-replies to anyone mentioning a keyword | <Iconicon="circle-xmark"color="#ef4444" /> | Unsolicited interaction |
82
+
| App auto-replies to users who reply to your post | <Iconicon="circle-check"color="#22c55e" /> | User engaged first—limit 1 reply. [Conditions apply](#gray-areas-explained)|
83
+
| AI-powered app generates and posts replies | <Iconicon="triangle-exclamation"color="#f59e0b" /> | Requires **prior approval** from X |
84
+
| App replies with "follow me for more!" to random users | <Iconicon="circle-xmark"color="#ef4444" /> | Spam, unsolicited |
85
+
| Utility app that unrolls threads when mentioned | <Iconicon="circle-check"color="#22c55e" /> | User-initiated utility |
88
86
</Tab>
89
87
<Tabtitle="Direct Messages">
90
88
| Scenario | Allowed? | Why |
91
89
|----------|:--------:|-----|
92
-
| Bot responds to DMs with helpful info | <Iconicon="circle-check"color="#22c55e" /> | User-initiated |
93
-
| Bot sends affiliate links when user DMs first | <Iconicon="circle-check"color="#22c55e" />*| User-initiated—must disclose affiliate relationship |
94
-
| Bot auto-DMs new followers with welcome message | <Iconicon="circle-xmark"color="#ef4444" /> | Unsolicited, even to followers |
95
-
| Bot bulk-DMs users about a product launch | <Iconicon="circle-xmark"color="#ef4444" /> | Spam |
96
-
| Support bot asks "How can I help?" after user DMs | <Iconicon="circle-check"color="#22c55e" /> | User-initiated conversation |
|Mobile app has "auto-like" feature for selected users| <Iconicon="circle-xmark"color="#ef4444" /> | Automated likes banned |
101
+
|App reposts content from a curated list | <Iconicon="circle-check"color="#22c55e" /> | OK for informational purposes, no bulk spam. [Conditions apply](#gray-areas-explained)|
|App follows back anyone who follows it | <Iconicon="circle-xmark"color="#ef4444" /> | Bulk/aggressive following |
104
+
|App adds users to lists in bulk | <Iconicon="circle-xmark"color="#ef4444" /> | Indiscriminate list manipulation |
105
+
106
+
<Warning>**Automated likes are banned with no exceptions.** This applies to all apps—bots, mobile apps, browser extensions, or any integration.</Warning>
| Bot replies to random posts with affiliate links | <Iconicon="circle-xmark"color="#ef4444" /> | Unsolicited spam |
117
-
| Giveaway bot that requires follows/retweets to enter | <Iconicon="triangle-exclamation"color="#f59e0b" /> | Risky—can be seen as engagement manipulation |
| App replies to random posts with affiliate links | <Iconicon="circle-xmark"color="#ef4444" /> | Unsolicited spam |
113
+
| Giveaway app that requires follows/retweets to enter | <Iconicon="triangle-exclamation"color="#f59e0b" /> | Risky—can be seen as engagement manipulation |
| Tip service that sends crypto when user requests | <Iconicon="circle-check"color="#22c55e" /> | User-initiated—comply with financial regulations. [Conditions apply](#gray-areas-explained)|
0 commit comments