linkedin — ɳSelf documentation.

LinkedIn Plugin

LinkedIn publishing integration with OAuth 2.0 and post history. Pro plugin. Requires license.

Tier required

Tier	Monthly	Annual	Includes this plugin?
Free	$0	$0	No
Any bundle	$0.99/mo	$9.99/yr	No (not in a bundle)
ɳSelf+	$3.99/mo	$39.99/yr	Yes (all pro plugins)

Minimum tier: ɳSelf+ ($3.99/mo or $39.99/yr). This plugin is not in any single product bundle, it requires ɳSelf+ for access.

Bundle membership

Not currently bundled. Requires ɳSelf+ ($3.99/mo or $39.99/yr) which includes all 46 pro plugins and all apps.

Or purchase ɳSelf+ via ɳSelf+ ($39.99/yr).

Install

nself license set nself_pro_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
nself plugin install linkedin
nself build

The license is validated against ping.nself.org/license/validate. Tier is checked server-side; insufficient tier returns an error.

Description

The LinkedIn plugin connects a LinkedIn account via OAuth 2.0, posts to a member’s LinkedIn feed with optional image attachments, and tracks post history for later reference. It also exposes a Claw tool descriptor so ɳClaw can publish on the user’s behalf.

OAuth tokens are stored per source_account_id, so multi-tenant ɳSelf installs keep each user’s LinkedIn credentials isolated. The plugin is currently in beta status.

Configuration

Env Var	Default	Description
`DATABASE_URL`	none	Postgres connection string (required)
`LINKEDIN_CLIENT_ID`	none	LinkedIn OAuth app client ID (required)
`LINKEDIN_CLIENT_SECRET`	none	LinkedIn OAuth app client secret (required)
`LINKEDIN_REDIRECT_URI`	none	OAuth callback URL (required)
`LINKEDIN_INTERNAL_SECRET`	none	Internal request signing secret (required)
`PORT`	`3722`	LinkedIn service port
`BIND_ADDRESS`	`127.0.0.1`	Bind address for the service
`nself`	none	License key (read from CLI by default)

Ports

Port	Purpose
3722	LinkedIn service REST API

Database Schema

2 tables added to your Postgres database (prefix: np_linkedin_):

np_linkedin_tokens: OAuth access and refresh tokens per account
np_linkedin_posts: published post history with status

REST API

GET  /health: Health check
GET  /oauth/start: Begin OAuth connection
GET  /oauth/callback: Complete OAuth handshake
POST /posts: Publish a post to the connected feed
GET  /posts: List published posts

Examples

Publish a text post

curl -X POST http://localhost:3722/posts \
  -H "Content-Type: application/json" \
  -d '{"text":"New ɳSelf release shipping today.","visibility":"PUBLIC"}'

List recent posts

curl http://localhost:3722/posts

Source

Source-available (license required to run): plugins-pro/paid/linkedin/

Note: plugins-pro is a private repository. Source access is granted to ɳSelf+ subscribers and Enterprise customers.

linkedin