API Reference/Endpoints

Submit a checkpoint code

POST/api/linkedin/connect/{account_id}/2fa

Resolves a 2FA or OTP checkpoint returned while connecting an account. Only valid while that account's status is awaiting_2fa.

Authentication

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

Path parameters

FieldTypeDescription

account_id *stringThe account_id returned by the connect call.

Body parameters

FieldTypeDescription

code *stringThe 2FA or OTP code. Pass the literal string "TRY_ANOTHER_WAY" instead to switch checkpoint type when possible.

A 200 doesn't always mean the account is connected — LinkedIn can hand back a different checkpoint (e.g. moving from an app-tap to a code). Check status afterward to confirm.

Errors

·400 Bad Request. code is missing, or the code was rejected by LinkedIn.·401 Unauthorized. The key is missing, malformed or has been rotated.·404 Not Found. No account with that id belongs to this key.·409 Conflict. The account isn't currently awaiting a checkpoint code.