API Reference/Endpoints

Connect a LinkedIn account

POST/api/linkedin/connect

Signs a LinkedIn account into Warmably. The password is used once for this call and never stored — from here on the session lives with the LinkedIn engine, not with you or us.

Authentication

Send your personal API key as a bearer token. A missing, malformed or revoked key returns 401.

Body parameters

FieldTypeDescription

label *stringA name for this account, shown in the dashboard.

li_email *stringThe LinkedIn account's login email.

li_password *stringThe LinkedIn account's password. Never persisted.

Response fields

FieldTypeDescription

account_idstringUUID for this connection. Use it with the status, checkpoint and action endpoints below.

This call returns 200 as soon as the account row is created — before LinkedIn has finished signing it in. Poll GET /api/linkedin/connect/{account_id}/status to see whether it landed on connected, needs a checkpoint code (awaiting_2fa), or failed (error).

Errors

·400 Bad Request. label, li_email or li_password is missing.·401 Unauthorized. The key is missing, malformed or has been rotated.·500 Internal Error. The account row couldn't be created. Safe to retry.