LinkedIn

Connect a LinkedIn account

Signs in to LinkedIn with the member’s email and password from the chosen country, and takes a LinkedIn account seat on the plan once connected. With sender_id it signs a disconnected account in again, so its campaigns resume. When LinkedIn asks to confirm the sign-in, status is checkpoint_required and checkpoint_type says how: finish with Confirm a LinkedIn sign-in.

POST
/linkedin/login

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
emailstringrequired

The email the member signs in to LinkedIn with.

passwordstringrequired

The member's LinkedIn password, used for this sign-in and not stored by Bavlio.

Required string length: 1 - 200

countryenum<string>required

The country the member normally uses LinkedIn from, as an ISO 3166-1 alpha-2 code, with UK for the United Kingdom; the sign-in goes through a connection there.

Available options: US, CA, MX, CR, BR, AR, CL, CO, FR, UK, DE, NL, ES, IT, PT, BE, CH, AT, IE, SE, DK, FI, LT, LV, EE, PL, CZ, SK, HU, RO, UA, SI, HR, RS, AL, GR, CY, TR, IL, AE, EG, ZA, IN, PK, BD, JP, SG, MY, ID, TH, PH, AU

sender_idstring

The id of a disconnected LinkedIn account to sign in again, as the same member, so its campaigns resume. Leave out to add a new account.

Response

application/json

Success

idstringrequired

The LinkedIn account's id; campaigns refer to it as sender_id.

statusenum<string>required

connected: signed in and able to send. checkpoint_required: LinkedIn waits for the sign-in to be confirmed. disconnected: signed out; connect it again with its id as sender_id to resume its campaigns.

Available options: connected, checkpoint_required, disconnected

namestring | nullrequired

The member's name on LinkedIn; null until a sign-in completes.

kindenum<string> | nullrequired

Whether the LinkedIn account is premium or free; null until a sign-in completes.

Available options: premium, free

profile_urlstring | nullrequired

The member's LinkedIn profile URL; null when unknown.

checkpoint_typeenum<string> | nullrequired

How LinkedIn wants the sign-in confirmed while status is checkpoint_required: email, sms, authenticator_app or code (send that code), or app_approval (the member approves the sign-in in the LinkedIn app, then confirm without a code). Null otherwise.

Available options: email, sms, authenticator_app, app_approval, code

sent_tostring | nullrequired

Where LinkedIn sent the code, as LinkedIn reports it; null when no code was sent.

countryenum<string> | nullrequired

The country LinkedIn sees the account from, as an ISO 3166-1 alpha-2 code, with UK for the United Kingdom; null when unknown.

Available options: US, CA, MX, CR, BR, AR, CL, CO, FR, UK, DE, NL, ES, IT, PT, BE, CH, AT, IE, SE, DK, FI, LT, LV, EE, PL, CZ, SK, HU, RO, UA, SI, HR, RS, AL, GR, CY, TR, IL, AE, EG, ZA, IN, PK, BD, JP, SG, MY, ID, TH, PH, AU

connected_atstring | nullrequired

When the account was connected, ISO 8601; null while it is not connected.

campaign_countintegerrequired

How many campaigns, archived ones aside, send from this account.

held_backobject | nullrequired

Why and until when Bavlio holds the account back after a LinkedIn limit; null when it doesn't.

all_messagesbooleanrequired

Whether the inbox also keeps the account's conversations outside campaigns.

message_importobject | nullrequired

Progress of bringing in the account's recent conversations; null while all_messages is off.