X and LinkedIn

X and LinkedIn are separate connections with separate developer apps. Both use OAuth 2.0.

X (Twitter)

Create a project and app

In the X Developer Portal, create a Project, then an App inside it. Standalone apps cannot use OAuth 2.0.

Set up User authentication

Enable OAuth 2.0, choose Web App as the app type, and set the callback URL:

https://api.yourdomain.com/connect/state

Set App permissions to Read and write and Direct message — the narrower presets will not satisfy the scopes below.

Copy credentials

Copy the OAuth 2.0 Client ID and Client Secret.

X_CLIENT_ID=your-client-id
X_CLIENT_SECRET=your-client-secret
X_REDIRECT_URI=https://api.yourdomain.com/connect/state

Scope	Grants
`tweet.read`	Read posts
`tweet.write`	Publish posts
`users.read`	Read profiles
`like.write`	Like posts
`list.write`	Manage lists
`dm.write`	Send direct messages
`offline.access`	Refresh tokens

To connect, go to Settings → Integrations in your workspace and click Connect on X.

X’s Free API tier allows a small monthly post volume and no read access to the timeline. Most real agent workloads need Basic or Pro. Check your tier before building against it — the flow will connect successfully and then fail at call time with a 403 if the endpoint is not in your tier.

Create an app

At LinkedIn Developers, create an app. It must be associated with a LinkedIn Page you administer.

Add products

Request Sign In with LinkedIn using OpenID Connect and Share on LinkedIn. To post as an organization you also need Community Management API, which requires LinkedIn’s approval.

Set the redirect URL

Under Auth → OAuth 2.0 settings, add:

https://api.yourdomain.com/connect/state

LINKEDIN_CLIENT_ID=your-client-id
LINKEDIN_CLIENT_SECRET=your-client-secret
LINKEDIN_REDIRECT_URI=https://api.yourdomain.com/connect/state

Scope	Grants
`openid`	OpenID Connect sign-in
`profile`	Basic profile
`email`	Email address
`w_member_social`	Post as the authorizing member
`w_organization_social`	Post as an organization Page

To connect, go to Settings → Integrations in your workspace and click Connect on LinkedIn.

Troubleshooting

Symptom	Fix
X: `unauthorized_client`	The app is not inside a Project, or OAuth 2.0 is not enabled.
X: connects then `403` on posting	App permissions are Read-only, or your API tier lacks the endpoint.
LinkedIn: `unauthorized_scope_error`	A requested scope’s product is not approved on the app.
LinkedIn: cannot post as organization	`w_organization_social` needs Community Management API approval, and the member must be a Page admin.
Either: redirect mismatch	The callback is not registered, or differs by scheme or trailing slash.

Getting started

Integrations

Open source

X (Twitter)

LinkedIn

Troubleshooting

​X (Twitter)

​LinkedIn

​Troubleshooting

X (Twitter)

LinkedIn

Troubleshooting