How accounts are provided
There are two ways to give Edges a LinkedIn account to work with — BYO (bring your own accounts) or Managed. Everything else — modes, rotation, limits — follows from this one choice.The two choices don’t change any quota — they change which limit system you have to plan around. In BYO the per-identity action limits are your ceiling. In Managed they’re ours to absorb, and your ceiling is your plan. See How Limits Work.
BYO and Managed aren’t exclusive. You can sync accounts for outreach — where the action has to come from a real person — and use managed for enrichment and search, where it doesn’t matter who ran it.
BYO — sync your users’ accounts
Bring your own accounts: connect your users’ own LinkedIn accounts through the Chrome Extension, native LinkedIn login, or by providing cookies. Use it when- The action must be attributable to a specific person — messages, invitations, InMail, profile views
- You are building on behalf of users who have their own LinkedIn accounts
- You need data only that account can see, such as its own connections or profile viewers
identity_mode: "auto" — see Auto Mode below.
Limitations
- Your users have to complete a connection step
- Sessions expire and accounts occasionally need reconnecting
- Capacity is bounded by how many accounts you have and what licence each holds
Managed accounts
Run actions without owning or connecting any LinkedIn account. Edges provisions and operates the accounts, handles their warm-up and rotation, and replaces them when needed.- You are extracting or searching public data at volume
- You have no user accounts to use, or don’t want to use them
- You are reselling data extraction and need capacity that isn’t tied to individual users
- You want to start immediately without a connection flow
Dedicated pools are set up with you rather than self-served. Start from the LinkedIn Integration page or talk to your Edges contact, and we will size it against the volume you’re planning for and confirm the setup timeline then.
- 1.5× standard credit cost
- Not available for every action. Anything that reads data belonging to a specific account — profile viewers, your own connections, your own messages — needs that account, so it requires a synced identity in
directmode - No attribution to a person, which rules it out for outreach
Choosing
1
Does the action have to come from a specific person?
Messages, invitations, InMail, or reading that account’s own data → sync your users’ accounts and run in
direct mode. Managed cannot do these.2
Otherwise, do you already have connected accounts?
Yes, and their combined capacity covers your volume → use them, with
identity_mode: "auto" to spread the load.3
Otherwise
→ Managed. If your volume is beyond what a shared allocation comfortably serves, that becomes a dedicated pool sized with you.
When an account goes invalid
Synced accounts occasionally need reconnecting — a session expires, or LinkedIn asks for a verification step. Edges surfaces this through LinkedIn integration webhooks so you can prompt the user, and runs blocked by it are recoverable once the account is valid again.Monitor & Recover
Watch for an invalid integration with webhooks, and reconnect it.
Recover a Blocked Run
Restart the runs that stopped while it was invalid.
How a run selects an identity
Identity modes control how Edges uses your integration accounts when executing actions. You can choose between three modes depending on your needs for control, automation, and cost.Available Identity Modes
string
The identity mode to use:
direct, auto, or managedarray
The identities to run on. Required for
direct. Most actions take exactly one — see Direct Mode for when more than one is accepted.Mode Comparison
Direct Mode
Full control over which accounts to use Usedirect mode when you need precise control over which integration accounts execute your actions.
Use Cases
- Actions requiring specific accounts (e.g.,
linkedin-extract-profile-viewers) - Using only a subset of your identities (e.g., sales team accounts only)
- Separating company-level calls from user-specific calls
- Compliance requirements for account attribution
Implementation
Name the identity the run should use:Example Request
Extract the profile viewers of one specific account:For actions that do support rotation,
direct distributes across the identities you list, preferring the one used least.Edges will filter out accounts that aren’t valid for the current action. For example, using LinkedIn identity IDs for a Sales Navigator action will result in a
NO_VALID_ACCOUNT_CONFIGURED error.You must provide at least one valid identity ID when using
direct mode.Auto Mode
Automatic distribution across all available accounts Useauto mode for automatic load balancing across all your valid integration accounts.
Use Cases
- Processing large batches of inputs
- Running parallel actions for better performance
- Actions with strict rate limits (visits, connections)
- Building resilient systems that continue working if some accounts become invalid
Implementation
You still need to configure identities and integration accounts yourself. Ensure you have at least one account with the right integration and subscription level for the action.
If you pass both
auto and identity_ids, the request runs in direct mode — naming identities is an explicit choice, so it wins.Managed Mode
Run actions on accounts Edges provisions and operates Usemanaged mode to execute actions without managing any integration accounts yourself.
Benefits
- No account setup required - Works even without any integration accounts
- Automatic load distribution - Optimal performance and parallelism
- No account issues to handle - Warm-up, rotation and replacement are Edges’s responsibility. Your throughput is still bounded by your plan’s rate limits
- Simplified workflow - Focus on your business logic, not account management
Implementation
Limitation: You cannot use
managed mode for actions that require specific accounts (e.g., linkedin-extract-profile-viewers). For these actions, use direct mode with the specific account that owns the data.
