Actions

Call the connectLinkedInAccount MCP tool

Connect a brand-new LinkedIn account, or reconnect an existing disconnected one, by minting a Unipile hosted-auth link. mode "connect" (no account_id) mints a link for a NEW account, gated by the workspace's paid seat limit (refuses with reason "no_seats" when the plan is full). mode "reconnect" (account_id required, from getLinkedInAccounts) re-links an EXISTING account: refuses with "not_found" if the account is not in this workspace, "not_disconnected" if it is currently healthy (nothing to reconnect), or "no_unipile_id" if it has never completed a first connection. Neither mode performs any LinkedIn action by itself: nothing changes in this workspace until a human opens the returned hosted_auth_url and completes the sign-in it walks through. Give that URL ONLY to the intended account owner (whoever holds it can link a LinkedIn login into this workspace) and tell them it expires in about 24 hours.

Called through the Actions bridge: the response is that tool's own result, wrapped as { data: <tool result> } under HTTP 200. Billing, daily-cap, and confirm-step outcomes are embedded INSIDE data, never remapped to an HTTP status (see the templated /api/v1/actions/{toolName} operation above for the full protocol, and x-mcp-actions for this tool's machine-readable scope/cap/confirm_behavior fields). Authentication, request-shape, and optional idempotency-protocol failures still use their documented non-200 statuses.

post/api/v1/actions/connectLinkedInAccount

Request

  • Base URL: https://app.reachium.io
  • URL: https://app.reachium.io/api/v1/actions/connectLinkedInAccount
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Optional caller-generated key (8-200 characters: letters, digits, dot, underscore, colon, or hyphen). A final tool result is replayed for the same key and body. An ambiguous result remains 409 under that key; reconcile external state before using a new key. Reuse with a different body returns 422.

Request body

mode'connect' | 'reconnect' required

"connect" mints a link for a brand-new account (account_id must be omitted). "reconnect" re-links an existing disconnected account (account_id required).

account_idstring uuid

Required when mode is "reconnect" (an existing, disconnected account from getLinkedInAccounts). Omit for mode "connect".

Response

The result of calling this tool.

dataunknown required
errorunknown required

Changes

No recorded changes to this operation across all 2 revisions of this API.