Features Pricing Blog Log in Start free trial
Workflow

Connect Twitter/X: Step-by-Step Guide

S
Sofia
/

Connecting your X (formerly Twitter) account to Sofia Creative enables you to publish tweets and threads directly from your workspace. This integration uses the modern OAuth 2.0 protocol, ensuring high security and a seamless authorization experience. You will need to create a project and app in the X Developer Portal to get started.

X Developer Account Required

You must have an approved X Developer account. The Free or Basic tiers are sufficient for standard automated posting via OAuth 2.0.

Step 1: Create a Project and App

X uses a "Project" structure to organize your apps. Each project can contain one or more apps that share usage limits.

  1. Log in to the X Developer Portal.
  2. Click Create Project on the dashboard. Give it a descriptive name (e.g., "Sofia Content") and select a use case like "Making a bot" or "Exploring the API".
  3. Once the project is created, click Add App (or "Create App") within that project.
X Developer Portal Dashboard - Create Project
Create a Project to house your Sofia Creative integration

Step 2: Enable User Authentication (OAuth 2.0)

Sofia Creative uses OAuth 2.0 for secure, temporary access to your account. You must explicitly enable this in your app settings.

  1. In your app dashboard, scroll down to the User authentication settings section and click Set up.
  2. Toggle on OAuth 2.0.
  3. Under "Type of App," select Web App, Automated App or Bot.
  4. Set the App permissions to Read and write to allow Sofia Creative to post on your behalf.
OAuth 2.0 Authentication Settings on X
Enable OAuth 2.0 and set permissions to "Read and write"

Step 3: Configure Redirect / Callback URL

The Callback URL is the specific address where X sends the user back after they authorize your app. This must match your site's domain exactly.

  • Locate the Callback URI / Redirect URL field in the authentication settings.
  • Enter your unique callback URL:
    https://your-domain.com/publishing/connect/callback/twitter
  • Enter your Website URL in the field below.
  • Click Save at the bottom of the page.

Step 4: Retrieve Client ID and Client Secret

Upon saving your authentication settings (or by navigating to the Keys and Tokens tab), X will provide your Client ID and Client Secret.

  • Copy the Client ID. This is your public identifier.
  • Copy the Client Secret. Important: This secret is only shown once. If you lose it, you will need to regenerate it.
Client ID and Client Secret in X Developer Portal
Securely copy your OAuth 2.0 Client ID and Secret

Step 5: Connect in Sofia Creative

Return to Sofia Creative to finalize the link between the two platforms.

  1. Navigate to Publishing → Connect Accounts and select the Twitter tab.
  2. Paste the Client ID and Client Secret into the respective fields.
  3. Click Save credentials then click the Connect button.
  4. Follow the X authorization prompt to grant Sofia Creative access to your account.
Sofia Creative Twitter Connection UI
Complete the connection in the Sofia Creative dashboard

Troubleshooting

  • "Client Not Found" / "Unauthorized": Double-check that your Client ID and Secret match exactly what is in the X Developer Portal. Ensure you are copying the OAuth 2.0 credentials, not the API Keys for OAuth 1.0a.
  • Callback URL Error: Ensure the URL in X matches your site's actual URL (including https://). Any discrepancy will block the connection.
  • Write Permission Hidden: If you don't see the "Read and write" option, make sure you have selected "Web App, Automated App or Bot" as the app type.