Skip to main content
By the end of this page a LinkedIn account is connected and ready to send, past whatever checkpoint LinkedIn raises along the way, and you know how to bring it back if the connection later drops.
Where
Integrations→Integrations→LinkedIn Accounts
Your role needs
Read access to LinkedIn Accounts read-linkedin-accounts. Admin, Member and Viewer have it by default.
To create or change
create-linkedin-accounts to add one, update-linkedin-accounts to change one, on top of the permission above.
Your plan
Needs at least one seat for LinkedIn accounts.
If you cannot find this in your sidebar, your workspace may have a custom menu configuration. Contact support and we will check it for you.

​
Before you begin

  • LinkedIn accounts belong to the workspace you’re viewing. Switch first if you want to connect one somewhere else.
  • You sign in with the profile’s own LinkedIn email and password. There is no redirect to LinkedIn and no app to authorize.
  • Reconnecting a dropped account (and pausing, resuming or syncing one) all need update-linkedin-accounts on top of the read access above.

​
Steps

1

Open the connect dialog

Go to and choose Connect Account: at the top of the page if you already have accounts connected, or in the middle of the screen if this is the first one. If your plan’s LinkedIn seats are all in use, the button is greyed out instead; see Troubleshooting below.
2

Sign in with your LinkedIn credentials

Enter the LinkedIn email and password for the profile you want to connect, and optionally pick a Tag so you can filter and organize this account alongside your other connections. The password is not stored on our servers. It goes to our messaging provider, which uses it to sign in to LinkedIn as you. Submit with Connect LinkedIn Account.
3

Clear the checkpoint LinkedIn raises

Submitting always lands you on a connecting screen first: the account row is created straight away and the sign-in itself runs in the background, so the dialog waits and asks for its result every few seconds. You can’t close the dialog while it does. If nothing comes back after a few minutes it gives up with “Connection timed out. Please try again.”Once LinkedIn answers, either the connection is through and the dialog moves on to Configure, or LinkedIn raises one of five checkpoints:
  • One-Time Password: a 6-digit code LinkedIn sends to your email or phone.
  • Two-Factor Authentication: a 6-digit code from your authenticator app.
  • Approve on LinkedIn App: open the LinkedIn app on your phone and approve the sign-in request there. Nothing to type; the dialog keeps checking until LinkedIn says you approved it.
  • Resolving CAPTCHA: nothing to type either. This one is resolved automatically, behind a spinner.
  • Phone Verification: a phone number, entered with its international prefix.
Every checkpoint runs against a countdown, and the ones you type into also count your attempts. Clearing one can raise another: an emailed code followed by an authenticator code is a normal sequence, and each new checkpoint restarts the countdown and the attempt count.
LinkedIn decides which of the five checkpoints to raise, and when. This image shows the One-Time Password one; the other four look different but sit at the same point in the flow.
4

Set action limits and a schedule

Once the sign-in is through, the dialog shows the account type LinkedIn reports (LinkedIn Basic, LinkedIn Premium, Sales Navigator or LinkedIn Recruiter) and four cards of daily and weekly limits: Connection Requests, Messages, InMail and Profile Views. Each starts pre-filled with a recommended value and carries a hard maximum for that account type; a number above it is rejected, both by the form and by the save. On a Basic account InMail is Not available on Basic, fixed at zero and greyed out. Below the cards, Delay Between Actions spaces out individual actions, and Schedule sets the hours the account may act in: Monday to Friday, a morning and an afternoon block, in the timezone your browser is in at the moment you connect.Adjust any of it now, or come back to it later through the account’s own Edit action on the list. Then choose Save & Finish to close the dialog.
The account is already connected by this point. Closing the dialog instead of saving leaves it connected and running on the same default limits and the same Monday-to-Friday schedule, but only saving refreshes the list behind the dialog, so on that path you may have to reload the page before the new row appears.
5

Reconnect if the connection drops

An account whose session drops shows status Error, with the reason on the chip’s tooltip, and its row grows a Reconnect icon. The icon needs update-linkedin-accounts, and it only appears on an account that reached our messaging provider at least once. A sign-in that never got that far cannot be re-authenticated at all, and has to be deleted and connected again.Choose Reconnect, type the account’s LinkedIn password again, and submit. If LinkedIn challenges the sign-in, the dialog switches to the same six digit boxes as the checkpoint step above and asks you to enter the code; for an approval on your phone, it shows those boxes together with the line “Approve the sign-in request in the LinkedIn app on your phone.”Reconnecting keeps the exact same provider account, so its whole message history stays intact, and it doesn’t use up another seat.
A representative example: reproducing the underlying error state needs a genuinely dropped session, which can’t be seeded.

​
What happens next

The dialog closes and the new account is in the list, with an Active status chip.
The name, profile picture, headline and account type are read from LinkedIn as the connection lands, so a row can look sparse for a moment and then fill in. That read is also what settles the account type: if it comes back as something better than Basic, every limit still sitting at its Basic default moves up to the higher type’s recommended value, and anything you changed yourself is left alone. A brand-new account doesn’t start sending at the limits you just set. It ramps up gradually instead, and while it does, the row carries a chip saying it’s sending at a percentage of its configured limits: see LinkedIn action limits, schedule and ramp-up for how that works. Separately, an account without many LinkedIn connections gets a Low connections chip: outreach to new leads pauses until the network grows, while replies keep sending.

​
Troubleshooting

Your plan includes a limited number of LinkedIn seats and they are all in use. Hovering the button shows why: “You have reached your LinkedIn account limit. Upgrade your plan to connect more.” Deleting an account you no longer use frees its seat, since a deleted account is disconnected and archived rather than counted.
Both are final for that attempt: the dialog tells you to close it and try again, and there is no way to resume the same sign-in. What it doesn’t say is that the attempt left a row behind: the account is created the moment you submit your credentials, and it stays in the list showing Connecting… or Error.So starting over is two moves, not one. Delete that row first, then choose Connect Account again. Connecting a second time with the same email while the first row is still there is refused with “A LinkedIn account with this email already exists in this workspace.”
Two things hide it. It needs update-linkedin-accounts. Without that permission the row’s Pause, Resume, Reconnect and Sync actions are not drawn at all, leaving Edit, and Delete if your role has that one. And it only appears on an account that reached our messaging provider before dropping; one that failed on its very first sign-in has nothing to re-authenticate, so delete it and connect again. See How your channel credentials are handled for what happens to the account on the provider’s side when you do.

LinkedIn action limits, schedule and ramp-up

What each action limit means, and how a new account ramps up to it.

LinkedIn Chat

Read and answer the conversations a connected account starts.

How your channel credentials are handled

What happens to the password you type into this dialog, and how to disconnect.

Agent settings reference

Point an AI agent at a connected account once it’s ready.