Skip to main content
You need an X developer account with access to the X Developer Console. X API usage is billed per request, so your account needs credits (Billing > Credits) before StackOne can call the API.

​
Create an X developer app

Register an app in the X Developer Console to get OAuth 2.0 credentials.

1

Sign in to the X Developer Console

Sign in to your X Developer Console account with your X account.

  • In the left sidebar, under Access, click Apps.
The X Developer Console dashboard with Apps highlighted in the left sidebar
2

Start a new app

On the Apps page, click Create App.

The Apps page with the Create App button highlighted
3

Name the app and create it

In the Create New Client Application dialog, enter the app details.

  • Application Name: StackOne Integration
  • Under Project Access, keep your project selected so the app’s keys can call the X API.
  • Click Create.
  • The Application Created Successfully dialog shows OAuth 1.0 keys and a Bearer Token, which this connection does not use. Click Close.
The Create New Client Application dialog with the Application Name field, project checkbox and Create button highlighted

​
Configure user authentication

Enable OAuth 2.0 on the app and register StackOne’s redirect URL.

1

Open the user authentication settings

On the Apps page, open StackOne Integration.

  • On the Keys & Tokens tab, under OAuth 2.0 Keys, find User authentication settings and click Set up.
The app's Keys & Tokens tab with the Set up button for User authentication settings highlighted
2

Choose the app permissions and type

On the Authentication settings page, set how the app accesses X.

  • Under App permissions, select Read and write and Direct message.
  • Under Type of App, select Web App, Automated App or Bot (Confidential client). This type issues a Client Secret.
  • If you choose Native App (Public client) instead, X issues no Client Secret and you leave Client Secret blank in StackOne.
The Authentication settings page with Read and write and Direct message and Web App, Automated App or Bot selected
3

Add the redirect URL and save

Under App info, fill in the required fields.

  • Callback URI / Redirect URL: https://api.stackone.com/connect/oauth2/x/callback
  • Website URL: your company website, for example https://www.example.com
  • Click Save Changes.
The App info section with the Callback URI / Redirect URL and Website URL fields and the Save Changes button highlighted

​
Copy the OAuth 2.0 credentials

After you save, X displays the app’s OAuth 2.0 Client ID and Client Secret.

1

Copy the Client ID and Client Secret

In the Did you save your OAuth 2.0 Client Secret? dialog, click the copy button next to each value.

  • Client ID — the public identifier of your app. Paste it into the Client ID field in the StackOne Connector profile.
  • Client Secret — the app’s confidential key. Paste it into the Client Secret field in the StackOne Connector profile.
  • The Client Secret is only displayed once and cannot be retrieved later. If you lose it, open the app’s Keys & Tokens tab and click Regenerate next to Client Secret.
  • Store both values securely for use later, then click Close.
The Did you save your OAuth 2.0 Client Secret? dialog with the copy buttons for Client ID and Client Secret highlighted

​
Choose OAuth 2.0 scopes

X grants OAuth 2.0 scopes when the user authorizes your app, based on the scopes StackOne requests. Choose them in the StackOne Connector profile.

1

Enter the scopes

Enables actions: Add List Member, Append Media Upload, Block User, Create Bookmark, Create DM Conversation And Send Message, Create DM Message By Conversation ID, Create DM Message By Participant ID, Create List, Create Post, Delete Bookmark, Delete List, Delete Post, Finalize Media Upload, Follow User, Get Authenticated User, Get Blocked Users, Get Bookmarks, Get DM Conversation Events, Get DM Events, Get Liked Posts, Get Liking Users, Get List, Get List Members, Get List Posts, Get Media Upload Status, Get Muted Users, Get Pinned Lists, Get Post, Get Quoted Posts, Get Reposted By, Get Space, Get Spaces By Creator, Get Timeline, Get User By ID, Get User By Username, Get User Followers, Get User Following, Get User List Memberships, Get User Mentions, Get User Owned Lists, Get User Posts, Hide Reply, Initialize Media Upload, Like Post, Mute User, Pin List, Remove List Member, Repost Post, Search Recent Posts, Search Spaces, Unblock User, Unfollow User, Unlike Post, Unmute User, Unpin List, Unrepost Post, Update List, Upload Media

In the StackOne Connector profile, enter the scopes your integration needs in Scopes as a space-separated list. Include offline.access so the connection can refresh its access token after it expires (access tokens are valid for two hours). If you leave Scopes blank, StackOne requests every scope listed here.

​
Creating the StackOne Connector Profile

To create the Connector Profile in StackOne for X (Twitter):
1

Open the connector

Log in to StackOne, open Connectors, and select X (Twitter).
2

Choose actions and events

  • Click Add Profile.
  • If the connector offers more than one authentication method, set the Auth Method filter to OAuth 2.0.
  • Select the actions, and any events, to enable for this Connector Profile.
  • Click Continue.
3

Set up authentication

  • Select Authentication Type as OAuth 2.0.
  • Fill out the fields using details retrieved from your provider:
    • Client ID
    • Client Secret (Optional)
    • Scopes (Optional)
  • Click Create Profile.
Congratulations! The new Connector Profile now shows up on the connector page. If you created it as a project member rather than an admin, it starts disabled until a project admin enables it. You can now continue to Link Accounts for X (Twitter).