X (Twitter) Integration
Post updates, monitor mentions, and create issues from tweets.
Setup
Connect X from Settings → Integrations. The OAuth 2.0 flow uses PKCE for security. You will be redirected to X to authorize Velocity with the following scopes:
tweet.read— read your tweets and mentionstweet.write— post tweets on your behalfusers.read— read your profile informationoffline.access— refresh tokens for persistent access
Posting Tweets
From the integration settings page, use the tweet composer to post updates directly from Velocity. A character counter shows the 280-character limit. You can also configure auto-posting for:
- Milestone completion — tweet when a project milestone is reached
- Releases — announce new releases
- Changelogs — share changelog entries
Monitoring Mentions
The integration can fetch recent @mentions of your connected account. Mentions are displayed in the settings page with the tweet content, author, and timestamp.
Mentions that contain Velocity issue identifiers (e.g., ENG-42) are automatically linked to the corresponding issue.
Creating Issues from Tweets
Each mention has a Create Issue button. Clicking it creates a new Velocity issue with:
- Title derived from the tweet text
- Description containing the full tweet as a blockquote with a link to the original
- Assigned to the selected team
Token Management
X access tokens expire after 2 hours. Velocity automatically refreshes tokens using the stored refresh token before making API calls. If a refresh fails, you will need to reconnect the integration.