Administration

Manage your Linked API subscription status, seats, connected accounts, and rate limits from the terminal.

Admin commands use your Linked API Token and do not require an active account. They work even if no LinkedIn accounts are connected.

Subscription

bash

# Check subscription status
linkedin admin subscription status

# View current seats
linkedin admin subscription seats

# Set seats (updates existing or returns checkout link)
linkedin admin subscription set-seats --quantity 5 --type plus --period year

Accounts

bash

# List all connected accounts and pending sessions
linkedin admin accounts list

# Connect a new LinkedIn account (opens connection link)
linkedin admin accounts connect

# Create a fresh reconnection link for an account
linkedin admin accounts reconnect <accountId>

# Refresh stored profile URL, avatar, headline, and name
linkedin admin accounts reparse <accountId>

# Check connection session status
linkedin admin accounts session <sessionId>

# Cancel a pending connection session
linkedin admin accounts cancel-session <sessionId>

# Disconnect an account (irreversible)
linkedin admin accounts disconnect <accountId>

# Regenerate identification token
linkedin admin accounts regenerate-token <accountId>

Connection flow

bash

# 1. Start a connection session
linkedin admin accounts connect
# → Opens connection link, displays sessionId

# 2. User logs into LinkedIn in the opened page

# 3. Check session status (or wait for the command above to complete)
linkedin admin accounts session <sessionId> --json
# → {"status": "success"} when done

# 4. Verify the account appeared
linkedin admin accounts list

Reconnection flow

bash

# 1. Find accounts that require reconnection
linkedin admin accounts list
# → reconnection_required accounts include reconnectionLink when available

# 2. Create a fresh reconnection session if you need to replace the link
linkedin admin accounts reconnect <accountId>
# → Displays reconnectionSessionId and reconnectionLink

# 3. Open the reconnectionLink and complete LinkedIn login

# 4. Check session status
linkedin admin accounts session <reconnectionSessionId> --json

Webhooks

Register an endpoint that receives workflow and account events, inspect recent deliveries, and verify the endpoint end-to-end. A client may hold one active webhook at a time.

bash

# Register the webhook (fat inlines the workflow result; thin sends a reference)
linkedin admin webhook set https://example.com/hooks/linkedapi
linkedin admin webhook set https://example.com/hooks --payload-mode thin

# Show the active webhook
linkedin admin webhook get

# Switch payload mode
linkedin admin webhook set-payload-mode <webhookId> thin

# Delete the webhook (soft-delete: delivery history is kept)
linkedin admin webhook delete <webhookId>

# Inspect the most recent deliveries (debug feed, newest first)
linkedin admin webhook deliveries

# Re-arm an already-settled delivery for redelivery (reuses the same event id)
linkedin admin webhook replay <deliveryId>

# Emit a synthetic webhook.test event to verify the endpoint
linkedin admin webhook send-test

Limits

bash

# View system default limits
linkedin admin limits defaults

# View current limits for an account
linkedin admin limits get <accountId>

# View current usage against limits
linkedin admin limits usage <accountId>

# Set limits for an account
linkedin admin limits set <accountId> \
  --category stMessages --period daily --max 25

# Delete specific limits (falls back to defaults)
linkedin admin limits delete <accountId> \
  --category stMessages --period daily

# Reset all limits to defaults
linkedin admin limits reset <accountId>

Limit categories

Category	Description
`stPersonProfileViews`	Standard LinkedIn profile views
`stCompanyPageViews`	Standard LinkedIn company page views
`stConnectionRequests`	Connection requests sent
`stMessages`	Messages sent
`stSearchQueries`	LinkedIn search queries
`stReactions`	Post reactions
`stComments`	Post comments
`stPosts`	Posts created
`nvPersonProfileViews`	Sales Navigator profile views
`nvCompanyPageViews`	Sales Navigator company page views
`nvMessages`	Sales Navigator messages

Periods: daily, weekly, monthly.

For the complete HTTP API reference, see the Admin API docs.

PreviousCustom Workflows