accounts

Connect Account

Connect a LinkedIn account via the manual-paste fallback flow.

Most customers go through the one-click hosted-auth flow (start-connect above + the Unipile webhook). This endpoint is the escape hatch for:

  • Tim manually attaching an account he created in the Unipile dashboard
  • Pilot customers debugging issues where the hosted-auth webhook didn't fire
  • Internal automated tests

Flow:

  1. Reject duplicates: if a row with the same external_account_id already exists for this client, return 409 (avoids accidentally creating double-billing rows on retry).
  2. Probe Unipile with check_account_health. We allow warming / requires_action / unknown statuses through (just create the row in warming state — the P1.3 poller will reconcile). Only an actual network/auth error blocks creation.
  3. Always release the per-call adapter so we never leak the httpx connection pool — every call to get_linkedin_adapter() returns a fresh instance, so aclose() is mandatory.
post/api/v1/accounts

Request

  • Base URL: https://api.nudgelink.co (the document declares no server; this is the origin it was published from)
  • URL: https://api.nudgelink.co/api/v1/accounts
  • Auth: HTTP bearer

Request body

labelstring
external_account_idstring required
profile_urlstring
timezonestring nullable

Response

Successful Response

idstring uuid required
labelstring required
external_account_idstring nullable required
profile_urlstring nullable required
status'active' | 'warming' | 'paused_by_client' | 'paused_by_system' | 'requires_action' | 'banned' required
warmup_weekinteger required
daily_limitsobject nullable required
daily_invite_capinteger required
timezonestring
invite_pacestring
send_hour_startinteger
send_hour_endinteger
send_daysinteger[]
last_action_atstring date-time nullable required
ban_countinteger required
created_atstring date-time required
is_premiumboolean nullable
premium_kindstring nullable

Changes

No recorded changes to this operation across all 1 revision of this API.