Tracked Account Management

Direct answer

Tracked account management lets teams maintain the selected accounts that power TweetStream alerts through the dashboard or authenticated REST endpoints.

Dashboard workflow

Checkout normally creates the API key automatically. In the dashboard, use the Account Management tab to add the first watchlist, remove old handles, and confirm the account count before connecting a WebSocket client.

• Use handles without @; input is normalized before syncing
• Remove unused handles before adding new ones near your plan limit
• Use /api/me to verify active handles from your own tools

REST endpoints

API clients use JSON bodies with an accounts field. The value can be one string or an array of strings.

Propagation behavior

Account changes can take a short propagation window while tracking state syncs. Treat retries as idempotent: retry the same desired add or remove, then use /api/me or the dashboard count as the source of truth.

Dashboard vs REST

Dashboard management is best for onboarding and trial setup. REST management is best when your own system controls watchlists programmatically.

• Use dashboard setup for first watchlists
• Use REST for automated account rotation
• Use plan limits to avoid exceeding account capacity

Questions