X Integration
If you want to schedule posts on X, you'll need to create and configure an app for this platform. This guide will walk you through the setup process.
This guide covers the new Pay as you go X API platform. If you set up your app using the previous Free tier developer console, see the Legacy Setup guide.
1. Create a Developer account
To get started, you need an X Developer account. Go to the X Developer Portal and sign in with your X account.
- Click Sign Up and choose the Pay as you go plan.
- Accept the Developer Agreement and complete the payment setup.
2. Create an App
- In the Developer Portal, go to Apps from the left sidebar.
- Click Create App.
- Enter your app name.
- Select Production for the Environment.
- Select the use case that best fits your needs.
- Enter an app description.
3. App details (Optional)
This step is mandatory for users providing Software as a Service (SaaS) through Mixpost Enterprise. However, if you are using Mixpost internally, this step is not required.
- Select your app from the list.
- Click the pencil icon next to the app name.
- Upload the App logo.
- Enter App description.
- Click on Save button.
4. User authentication settings
- Select your app from the list.
- On the right side, go to the OAuth 2.0 Keys section and click Edit settings.
- In the App permissions section, select Read and write.
- In the Type of App section, choose Web App, Automated App or Bot.
- Enter the Callback URI/Redirect URL in the provided field:
https://example.com/<MIXPOST_CORE_PATH>/callback/twitter
<MIXPOST_CORE_PATH> with your own value<MIXPOST_CORE_PATH> is a placeholder for the MIXPOST_CORE_PATH environment variable — the path prefix Mixpost is served under.
- Set to a prefix, for example
mixpost— use that value:https://example.com/mixpost/... - Empty — Mixpost is served from the root of your domain, so remove the placeholder and the slash that follows it:
https://example.com/...
MIXPOST_CORE_PATH is empty by default in Pro v7+ and Enterprise v8+. In earlier versions, and in Lite, it defaults to mixpost.
Callback URLs — callback/..., inbox-webhook/..., uninstall-callback/... and, in Enterprise, payment-webhook — can carry a different prefix from the rest of your instance, because they follow MIXPOST_CALLBACK_PATH whenever that variable is set. For the OAuth Redirect URI you do not have to assemble it at all: the provider's service form in the Mixpost dashboard shows the exact URL, ready to copy.
- In the Website URL field, enter your website URL.
- Click Save.
5. Copy the credentials to Mixpost
After configuring user authentication settings, you need to generate API Key and API Secret.
- On the selected app page, go to the OAuth 1.0 Keys section.
- Click Regenerate to generate new keys.
Copy these credentials, then navigate to your Mixpost dashboard and paste them into the X third-party service form. Make sure to select Pay as you go for the Tier and click Save.
- Pro and Enterprise
- Lite
Navigate to the User Menu at the bottom left, click Admin Console, and then click on Services from the left sidebar.
Click on Services from the left sidebar.
6. Done
You can test your app by adding your X account to Mixpost and scheduling posts.
- Pro and Enterprise
- Lite
Navigate to a workspace, then select Social Accounts from the left sidebar and click Add Account.
Select Social Accounts from the left sidebar and click Add Account.