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 active Engagement Identities
- Live feedback on current billing status
Identity Types Comparison
| Standard Identity | Engagement Identity |
|---|
| Credit-free outreach | ❌ | ✅ |
| Other actions cost credits | ✅ | ✅ |
| Billed | No (included in plan) | Yes (monthly) |
API type field | standard | engagement |
Pricing & Billing
We invoice active Engagement Identities during the month. You are billed based on the highest number of active Engagement Identities at any point in your billing cycle (peak), not the total number of Engagement Identities that were ever active.
When is an Engagement Identity active or inactive?
- Active — An Engagement Identity is counted as active when:
- You add a LinkedIn integration to it (connect an account), or
- You call an action with that identity (e.g. message, connect, extract conversations).
- Inactive — An Engagement Identity becomes inactive when:
- It has not been used in any action for 30 days, or
- You synchronized a LinkedIn account but have not called any action with that identity for 5 days.
Once inactive, that Engagement Identity no longer counts toward your billed count until it becomes active again (e.g. you run an action with it or connect a new integration).
How we count: peak of active Engagement Identities
Your monthly charge is based on the maximum number of active Engagement Identities you had at the same time during the cycle.
Example: You start the month with 5 active Engagement Identities. You add 3 more (8 active). Then 2 become inactive (6 active). You add 2 more (8 active). Later, 3 become inactive (5 active). You are billed for 8 — the highest count of active Engagement Identities during the month — even though 10 Engagement Identities were active at some point.
Engagement Identities are billed monthly based on this peak number of active Engagement Identities in the 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.
Billing Examples
| Scenario | Current Cycle Billed | Next Cycle Billed |
|---|
| Peak of 10 active Engagement Identities, then you delete all 10 | 10 | 0 |
| Peak of 10 active Engagement Identities, delete 10, recreate 10 (all active again) | 10 | 10 |
| Peak of 3 active Engagement Identities, delete 1, don’t recreate | 3 | 2 |
| Peak of 3 active Engagement Identities, delete 1, recreate 1 | 3 | 3 |
Quick Start
- Enable Engagement Identities in Developer Settings and fill billing details
- Create an Engagement Identity via API with
"type": "engagement"
- Connect a LinkedIn account to your Engagement Identity using the Connect Integration endpoint
- 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:
| Action | Endpoint |
|---|
| Connection Actions | |
| Connect LinkedIn Profile | linkedin-connect-profile |
| Connect Sales Navigator Profile | salesnavigator-connect-profile |
| Accept LinkedIn Received Invitations | linkedin-accept-invitations |
| Withdraw LinkedIn Pending Invitations | linkedin-withdraw-invitations |
| Follow LinkedIn Profile | linkedin-follow-profile |
| Messaging Actions | |
| Message LinkedIn Profile | linkedin-message-profile |
| Send LinkedIn InMail | linkedin-inmail-profile |
| Send Sales Navigator InMail | salesnavigator-inmail-profile |
| Engagement Actions | |
| Like LinkedIn Post | linkedin-like-post |
| Comment LinkedIn Post | linkedin-comment-post |
| Visit LinkedIn Profile | linkedin-visit-profile |
| Visit Sales Navigator Profile | salesnavigator-visit-profile |
| Invite People to LinkedIn Event | linkedin-invite-event |
| Extract Actions | |
| Extract LinkedIn Connections | linkedin-extract-connections |
| Extract LinkedIn Conversations | linkedin-extract-conversations |
| Extract LinkedIn Messages | linkedin-extract-messages |
| Extract LinkedIn Followers | linkedin-extract-followers |
| Extract LinkedIn Page Followers | linkedin-extract-page-followers |
| Extract LinkedIn Profile Viewers | linkedin-extract-profile-viewers |
| Extract LinkedIn Received Invitations | linkedin-extract-received-invitations |
| Extract LinkedIn Sent Invitations | linkedin-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.
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 of active Engagement Identities 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 support@edges.run for assistance with activation, billing, or best practices.
