LinkedIn OAuth connect, personal profile publishing, and scheduling on Aether.
LinkedIn is supported in V1 for OAuth connect, publishing, and scheduling on personal profiles — text posts, images, and PDF documents. Company page posting, inbox, and analytics are not available yet.
Connect an account
- Generate a Connect Link with
"platform": "linkedin" - Send the
urlto your user — they authorize via LinkedIn OAuth - After OAuth completes, the profile appears via
GET /v1/profiles
Self-hosted deployments
Set LINKEDIN_CLIENT_ID and LINKEDIN_CLIENT_SECRET on your API server. Enable Sign In with LinkedIn using OpenID Connect and Share on LinkedIn on your LinkedIn developer app. Register redirect URI {NEXT_PUBLIC_API_URL}/v1/oauth/callback/linkedin (e.g. http://localhost:3001/v1/oauth/callback/linkedin locally).
Content types
Text post
{
"text": "We just shipped LinkedIn on Aether 🚀",
"profileIds": ["prof_li123"]
}Image post
{
"text": "New visual from the launch",
"profileIds": ["prof_li123"],
"mediaUrls": ["https://cdn.example.com/hero.jpg"]
}PDF document post
{
"text": "Our Q1 report is live",
"profileIds": ["prof_li123"],
"mediaUrls": ["https://cdn.example.com/report.pdf"],
"overrides": {
"linkedin": {
"documentTitle": "Q1 Report"
}
}
}Platform overrides
| Field | Description |
|---|---|
documentTitle | Title shown on PDF document posts (max 255 chars) |
disableLinkPreview | Set true to disable link preview on text posts |
organizationUrn | Coming soon — company page posting requires LinkedIn Community Management API approval |
First comment
Pass firstComment at the post level or in overrides.linkedin to publish a comment immediately after the post goes live.
Scheduling
Pass scheduledFor with an optional timezone — same as other platforms. Posts are queued and published by the post worker.
Rate limits
LinkedIn enforces roughly 100 API calls per member per day for posting-related endpoints. Exceeding the limit returns a platform error.
Not available for LinkedIn yet
| Feature | Status |
|---|---|
| Company page posting | Requires Community Management API (Phase 2) |
| Articles and native video | Not implemented in connector |
| Inbox / comment sync | Not supported |
| Post and account analytics | Connector does not implement metrics fetch yet |
Verification checklist
After configuring your LinkedIn developer app and API env vars:
- Dashboard → Profiles → Connect → LinkedIn (must be enabled)
- Complete OAuth → profile appears with
platform: "linkedin" - Publish a text post → visible on your LinkedIn feed
- Publish an image post and a PDF document post
- Optional: schedule a post ~10 minutes ahead and confirm it publishes on time
| Symptom | Fix |
|---|---|
| LinkedIn grayed out in connect dialog | Rebuild @aether/shared after adding linkedin to V1_PLATFORMS |
unauthorized_scope on OAuth | Enable Share on LinkedIn + OIDC products in LinkedIn portal |
| Redirect error | LinkedIn redirect URI must match {NEXT_PUBLIC_API_URL}/v1/oauth/callback/linkedin exactly |
See MCP Server and Node.js SDK for connect and publish examples.