Skip to main content

What are Engagement Identities?

Engagement Identities are a special type of identity on Edges, allowing you to run a broad set of outreach actions on LinkedIn and Sales Navigator without consuming credits. They are ideal for building SaaS products or AI agents that enable users to engage on LinkedIn or create outreach sequences, while optimizing credit costs at scale.
Engagement Identities must be enabled first from the Developer Settings page. Billing details must be filled before activation is confirmed.

Key Benefits

  • Access a predefined list of free outreach actions
  • Keep using all other actions — paid at the normal credit rate
  • Create Engagement Identities via UI or API
  • Monthly billing based on peak usage
  • Live feedback on current billing status

Identity Types Comparison

Standard IdentityEngagement Identity
Credit-free outreach
Other actions cost credits
BilledNo (included in plan)Yes (monthly)
API type fieldstandardengagement

Pricing & Billing

Engagement Identities are billed monthly based on the peak number of active Engagement Identities during your billing cycle.
  • Starting at $7.99/identity/month
  • Pricing is dynamic: unit cost decreases as volume increases.
  • Pricing details available at edges.run/pricing?mode=outreach.
  • If an Engagement Identity is deleted or switched back to standard mid-month, it still counts for billing in the current cycle.
  • If none are used during a month, billing is zero.
We will introduce the notion of “active identities” in a future update to provide more granular billing control.

Quick Start

  1. Enable Engagement Identities in Developer Settings and fill billing details
  2. Create an Engagement Identity via API with "type": "engagement"
  3. Connect a LinkedIn account to your Engagement Identity using the Connect Integration endpoint
  4. Execute actions — use any of the included actions listed below; they’ll run without consuming credits

Included Actions

The following actions are included for free when executed via an Engagement Identity:
ActionEndpoint
Connection Actions
Connect LinkedIn Profilelinkedin-connect-profile
Connect Sales Navigator Profilesalesnavigator-connect-profile
Accept LinkedIn Received Invitationslinkedin-accept-invitations
Withdraw LinkedIn Pending Invitationslinkedin-withdraw-invitations
Follow LinkedIn Profilelinkedin-follow-profile
Messaging Actions
Message LinkedIn Profilelinkedin-message-profile
Send LinkedIn InMaillinkedin-inmail-profile
Send Sales Navigator InMailsalesnavigator-inmail-profile
Engagement Actions
Like LinkedIn Postlinkedin-like-post
Comment LinkedIn Postlinkedin-comment-post
Visit LinkedIn Profilelinkedin-visit-profile
Visit Sales Navigator Profilesalesnavigator-visit-profile
Invite People to LinkedIn Eventlinkedin-invite-event
Extract Actions
Extract LinkedIn Connectionslinkedin-extract-connections
Extract LinkedIn Conversationslinkedin-extract-conversations
Extract LinkedIn Messageslinkedin-extract-messages
Extract LinkedIn Followerslinkedin-extract-followers
Extract LinkedIn Page Followerslinkedin-extract-page-followers
Extract LinkedIn Profile Viewerslinkedin-extract-profile-viewers
Extract LinkedIn Received Invitationslinkedin-extract-received-invitations
Extract LinkedIn Sent Invitationslinkedin-extract-sent-invitations

Usage Guide

Requirements & Limitations

  • Account levels matter: Actions requiring Sales Navigator will only work if the underlying LinkedIn account has proper access.
  • The API’s global rate limit applies (default: 120 req/min).
  • A reasonable usage is expected to avoid overload for Edges and client platforms. Abuse may result in throttling or degradation.

API Usage

You can manage Engagement Identities via API using the type parameter. See the Create an Identity endpoint for full request body details.
# Create an Engagement Identity
POST /v1/identities
{
  "name": "Sales Outreach Identity",
  "timezone": "America/New_York",
  "type": "engagement"
}
The identity type cannot be changed after creation. If you need to switch an identity from standard to engagement (or vice versa), you must delete the existing identity and create a new one with the desired type.
Each identity response includes a type field indicating whether it’s "standard" or "engagement".

Monitor Your Usage

You can monitor your monthly Engagement Identity usage directly in the Identities page in the Edges dashboard. It shows your current peak and billing forecast for the cycle.
Use Engagement Identities for high-volume, repetitive outreach actions (connect, message, follow) and keep standard identities for more occasional or data extraction workflows.

Need Help?

Reach out to the Edges team via chat or at [email protected] for assistance with activation, billing, or best practices.