Skip to main content
Because X (Twitter) does not provide a standard open API for third-party tools, you must create your own App in the X Developer Portal and connect it to PaddyPost. This guide walks you through the entire process.

​
Prerequisites

Before you begin, ensure you have:
  • A verified X (Twitter) account with a confirmed phone number.
  • Admin access to your PaddyPost installation.

​
Step 1: Create a Developer Account

1

Sign Up

Go to developer.twitter.com and sign up for a Free developer account.
2

Describe Use Case

You will be asked to describe how you will use the Twitter API. You can use the following text as a template:
“Using Twitter’s API, I’ll schedule and publish tweets for my business to maintain an active presence. I will leverage the API to post content seamlessly and, if available on my tier, view performance analytics to improve my engagement strategies.”
3

Accept Terms

Accept the Developer Agreement to complete the signup.

​
Step 2: Create a Project and App

1

Access the Dashboard

Log in to the X Developer Portal Dashboard.
2

Create Project

If you haven’t already, create a new Project. Give it a name like “PaddyPost Integration” and select the appropriate use case (e.g., “Building tools for business”).
3

Create App

Within your project, click Add App or Create App.
  • App Name: Choose a unique name (e.g., “MyCompany Scheduler”). This name will be visible to you when you authorize the app.
  • Click Next to proceed.
4

Save Keys (Optional for now)

You will be shown API Key and Secret immediately. You can copy them now, but we will regenerate them in a later step to ensure we have the correct permissions applied first.

​
Step 3: Configure Authentication Settings

This is the most critical step. Incorrect settings here will prevent your account from connecting.
1

Navigate to App Settings

In the sidebar, select your App (it must be under your Project). Click on the Settings tab (gear icon).
2

Set Up User Authentication

Scroll down to User authentication settings and click Set up.
3

Configure Permissions

Update the settings exactly as follows:
  • App permissions: Select Read and Write.
  • Type of App: Select Web App, Automated App or Bot.
4

Enter URLs

You need to provide the callback URL from your PaddyPost instance.
  • Callback URI / Redirect URL: Copy this from your PaddyPost Services > X (Twitter) page.
    • Example: https://app.paddypost.com/paddypost/callback/twitter
  • Website URL: Enter your main company website URL (e.g., https://your-company.com).
5

Save

Click Save at the bottom.

​
Step 4: Generate API Credentials

Now that permissions are set to “Read and Write”, you must generate the keys that PaddyPost will use.
1

Go to Keys & Tokens

Click on the Keys and Tokens tab at the top of the App settings page.
2

Regenerate Consumer Keys

Find the API Key and Secret section (sometimes labeled Consumer Keys).
  • Click Regenerate.
  • Copy the API Key and API Secret immediately. Store them in a secure place.
Crucial: You must use these Consumer Keys. Do NOT use the “OAuth 2.0 Client ID and Secret”.

​
Step 5: Configure PaddyPost Service

1

Open PaddyPost Services

Log in to PaddyPost as an Admin and navigate to Services in the sidebar.
2

Edit X (Twitter)

Click on the X (Twitter) service to edit it.
3

Enter Credentials

  • API Key: Paste the API Key you copied in Step 4.
  • API Secret: Paste the API Secret you copied in Step 4.
  • Tier: Select Free (or Basic/Pro if you have upgraded).
  • Active: Toggle the switch to On.
4

Save

Click Save to apply the configuration.

​
Step 6: Connect Your Account

1

Go to Accounts

Navigate to the Accounts page in the PaddyPost sidebar.
2

Add Account

Click Add Account and select X (Twitter).
3

Authorize

You will be redirected to X (Twitter). Click Authorize app to grant permission.

​
Troubleshooting

This usually indicates a permission issue.
  1. Check App Permissions: Ensure Read and Write is selected in “User authentication settings”.
  2. Regenerate Keys: If you changed permissions after generating keys, you must regenerate the API Key and Secret.
  3. Check Tier limits: If you are on the Free tier, you are limited to 1,500 posts per month and cannot read data.
If you are unable to connect or see errors about access levels, check if your App is ‘standalone’.
  1. Go to the X Developer Dashboard.
  2. Ensure your App is listed under a Project card.
  3. If it is listed as “Standalone Apps” (no project), click Add App inside your Project card and select your existing app to move it into the project. This is required for v2 API access.
Ensure the Callback URI in X Developer Portal matches exactly what is displayed in your PaddyPost Services page, including https:// and no trailing spaces.