This repo is intentionally honest about what a substack to linkedin api can and cannot do.
- Read Substack source: RSS/import/public content depending on workflow. Risk level: Low.
- Generate LinkedIn-native copy: Requires adaptation rules. Risk level: Low.
- Schedule post: Requires queue and timezone logic. Risk level: Medium.
- Publish to LinkedIn: Official LinkedIn OAuth/API boundary. Risk level: Medium.
- Track subscribers from LinkedIn: Requires attribution layer. Risk level: Medium.
- OAuth tokens expire or lose permissions after platform security changes.
- Browser/session-based automations break when the platform updates UI or anti-abuse rules.
- Scheduled jobs publish duplicate content if idempotency keys are missing.
- Medium and Substack workflows need special handling because their public write surfaces are not equivalent to LinkedIn, X, Bluesky, or Threads.
- A generic social post can damage performance when it ignores platform-native formatting.
- Use official APIs and documented permissions where they exist.
- Keep credentials server-side and rotate them safely.
- Preview every platform payload before scheduling.
- Use idempotency keys for every write request.
- Emit webhook events for success, failure, and reconnect states.
- Avoid presenting unsupported platform behavior as official API capability.
For a hosted workflow that handles these details, use Narrareach.