Product Updates

​

API

• Search Sales Navigator Company Metrics — New action salesnavigator-search-company-metrics: total-count metrics for a Sales Navigator company search, with its own request/response schema.
• Search Sales Navigator People Metrics (rename) — salesnavigator-search-metrics is renamed to salesnavigator-search-people-metrics.
• Backward compatibility — salesnavigator-search-metrics remains accepted as an alias; existing callers are not broken.

​

App

• Search identities by UID — You can search for identities by their UID in the Identities page in the dashboard.

​

Improvements

• LinkedIn outreach (async only) — linkedin-inmail-profile, linkedin-message-profile, linkedin-visit-profile, linkedin-connect-profile, and salesnavigator-inmail-profile now have stricter pacing in async : big volume will take a little bit longer as usual; live mode is unchanged : you still have to space your call yourself.
• LinkedIn checkpoint / CAPTCHA — Fewer automatic attempts to solve captcha during identity login checkpoints (reduces 524 timeouts). If resolution still does not complete in time, responses may return a CAPTCHA checkpoint; poll POST /v1/identities/{identity_uid}/integrations/linkedin/checkpoint with {} until it clears, then handle any next checkpoint per Resolve LinkedIn Checkpoint.

​

Documentation

• Resolve LinkedIn Checkpoint — Documented CAPTCHA after maximum attempts, reduced captcha attempt limit (524 mitigation), polling with {}, and follow-on checkpoints. Checkpoint API

​

API

• Incremental Sync Mode — New sync_mode parameter (full or incremental) for async and scheduled runs. Fetch only new data since the last retrieval instead of the full dataset. Available on engagement-free actions with Engagement Identities only. Learn more
• Continue a Run — New endpoint POST /v1/runs/{run_uid}/continue to trigger incremental updates on async runs.
• Cursor-based pagination on run outputs & inputs — /v1/runs/{run_uid}/outputs and /v1/runs/{run_uid}/inputs now use cursor-based pagination by default via X-Pagination-Next. The offset parameter is deprecated. Pagination guide

​

Improvements

• Proxy Retry Logic — 502 proxy errors are now retried internally with sticky IP fallback before being returned, reducing transient failures.
• Identity Sync — Webhook notifications are no longer sent during pending in-app challenges.
• LK_BAD_COOKIE errors now return the affected identity_uid.
• Identity is_active property — Identities now expose an is_active field. Inactive engagement identities are excluded from subscription renewals.
• Output: headline deprecated, use summary — On Search Sales Navigator People, Saved People, Company Employees, Search LinkedIn People, and Search LinkedIn Company Employees, the headline output is deprecated (retroactive). Use summary, which now correctly contains the profile summary; headline was a naming mistake. Action docs.
• Extract Sales Navigator Company — New action. Inputs: sales_navigator_company_url or sales_navigator_company_id. Outputs include country, city, postalCode and full company profile data. Action docs.

​

App

• Subscription & pricing display — Credits plan: discounted base_prices and total_price when a credit discount applies; total_price when a global discount applies. Engagement identities: count and total_price (with discount when applicable) are shown; engagement price is added to the selected plan total so you see the full amount (credits + engagement identities). Subscription modal shows the credit plan total with or without discounts applied.
• LIMIT_REACHED errors — Now include params.appendix and params.timespan to distinguish the limit: third-party API (API_FUSE_LIMIT daily, API_RATE_LIMIT per minute) vs product limits (MINUTE_LIMIT, DAILY_LIMIT). Integrations should inspect appendix for better retry logic. Rate Limits · Error Reference.

​

Documentation

• Engagement Identity pricing — Billing is based on the peak number of active Engagement Identities during the month. Documented when an Engagement Identity is active (LinkedIn integration added or action called) vs inactive (30 days without any action, or 5 days after syncing without calling an action). Engagement Identities
• Error Reference — Error page updated: expanded Quick Reference Table with all error labels, HTTP codes, categories, and retry guidance; Error scopes; Handling 429 (Edges vs LinkedIn, params.appendix / params.timespan); Handling 424 LinkedIn errors with example code. Error Reference

​

API

• Extract Sales Navigator Company — New action to extract full Sales Navigator company data (revenue, description, employee counts, etc.) from a company page. Extract Sales Navigator Company

​

Improvements & Fixes

• Extract LinkedIn Conversations — Maximum conversations limit increased to 15,000; related validations updated. Error handling improved.
• Extract LinkedIn School Alumnis — Maximum alumni results limit set to 1,000.
• Extract LinkedIn Company Affiliates — Added safe optional chaining when accessing organization data to avoid runtime errors on missing fields.

​

API

• Extract LinkedIn Company Viewers — New action to extract viewers of a LinkedIn company page. Requires page admin access and a Premium page; returns viewers from the past year. Extract LinkedIn Company Viewers
• Extract LinkedIn People Educations — New action to extract education history (schools, degrees, fields of study, dates). Extract LinkedIn People Educations
• Extract LinkedIn People — Education output — New fields: title (degree + field of study), field_of_study, school_description. Breaking: degree_name is now correctly filled (first part of title before comma) or empty; it was previously sometimes filled with field_of_study.
• ID type changes — Several IDs changed from string to integer: linkedin_school_id, linkedin_company_id, original_linkedin_company_id, company_id in extract-people, experiences, company, company-employees-insights, recruiter-lite-search-people.
• LinkedIn experience outputs — Added job_contract_type, unblocking richer profile refresh data for migrations.
• Outputs APIs — Added extracted_at so consumers can reliably track when data was fetched.
• Extract LinkedIn People Post/React/Comment Activity — Output restructure:
  • Deleted: linkedin_original_post_url
  • Deprecated: original_author
  • Added source_post: source post info (2nd level) with linkedin_post_id, linkedin_post_url, content, author; returns null when no 2nd level post
  • Added linkedin_activity_id: unique ID depending on post type (original, simple reshare, reshare with comment)
  • Added activity_author: person who performs the activity
  • Updated author: now correctly filled with the author of the first-level (visible) post
  • Post levels table

​

Improvements & Fixes

• Billing — Next billed amount displayed on the platform now takes into account any discount applied on the subscription.
• Sales Navigator — Fixed company keyword search when spaces were double-encoded, restoring results for multi-word queries.
• Runs — Treated STATUS_404 and NO_RESULT as successful “no data” outcomes, reducing false failed runs while keeping transparency via last_info.
• Experience location — Improved completeness by inheriting the parent location when sub-experiences omit it.
• Accounts — Prevents false “no access” errors for some valid accounts.

​

Post Activity — Known Limitations

• Group posts: When the post is a group post, author may be empty (not handled).
• Component posts: Some posts (e.g. article, conversationComponent) may not have an author or require alternative resolution.

​

API

• Get Run Inputs — New endpoint to list all inputs for a run (including failed) and their errors. Get Run Inputs
• Runs — Error responses 404/409/422 added on run endpoints; auth_type removed from account schemas.

​

Documentation

• Callbacks — Data completeness: “all” vs “final” modes, how to verify and fetch results. Managing Callbacks
• Extract Post Activity — “Understanding Author Fields” (author, activity_author, source_post). Extract LinkedIn People Post Activity
• Run Outputs — Not available for live runs (explicit 422). Get Run Outputs
• Runs overview — Get run inputs added to endpoints table.
• Search Company Employees — Reuse a people search URL on a company in one call. Search Sales Navigator Company Employees
• Message & InMail — Voice/video format detection and conversion; Sales Navigator InMail unchanged. Message · InMail

​

Improvements & Fixes

• Run Outputs — Pagination fix; 422 for live runs instead of empty response.
• Workspace — OAuth page white-label (your logo); credit override no longer blocks when below plan.
• Retries — Internal automatic retries (proxy, limits, Sales Navigator). Do not change your implementation, but decrease error rates.
• Actions — linkedin_profile_id in more outputs; Search Metrics returns 0 values and supports # in URLs; Post Activity returns linkedin_activity_id; identities list pagination fixed.

​

What This Means for You

• Recover missed data — New inputs endpoint and clearer callback rules.
• Voice & video — Message and InMail send audio/video as voice or video messages where supported.
• Company search — Reuse a people search on a company in one call.
• Fewer manual retries — More cases trigger automatic retry.
• Clearer API — Pagination fixed; live runs return explicit error.
• Workspace — OAuth logo, credit override fix.

​

Deprecations

​

Page-Based Pagination Deprecated (Live Mode)

The deprecated parameters remain backward compatible. Existing integrations will continue to work, but we recommend migrating to cursors for new implementations.

1. Replace page parameter with cursor
2. Replace token parameter usage with cursor
3. Use the cursor value from X-Pagination-Next header
4. Handle cursor expiration - cursors expire after 24 hours (restart from beginning if error)

​

Improvements

• Unified pagination: Single cursor approach replaces mixed page/token system
• Data consistency: Cursors ensure stable pagination (valid for 24 hours)
• Simpler implementation: Always follow X-Pagination-Next header (no need to distinguish pagination types)

​

API Parameter Updates

• run_uid path parameter now includes UUID format validation and description

​

What This Means for You

• Existing integrations continue to work - page and token remain functional (backward compatible)
• New integrations should use cursor - recommended for all new implementations
• Async/Schedule modes unchanged - automatic pagination continues to work the same way
• SDK users: The nextPage helper still works - it returns the cursor URL

​

🚀 What’s New

​

🔒 LinkedIn Connection Reliability

• Fixed: LinkedIn accounts now reconnect smoothly without false authentication errors
• Fixed: Sales Navigator “upgrade required” errors no longer appear when visiting profiles within your daily limits
• Users should experience far fewer connection interruptions when running LinkedIn workflows

​

📬 LinkedIn Invitation Management

​

💰 Richer LinkedIn Profile Data

• Dynamic headlines shown by LinkedIn
• Job summaries and descriptions
• Work experience details previously unavailable

​

⚡ One-Shot Callbacks for Automation Tools

• Receive one notification when a job finishes instead of multiple callbacks during execution
• Dramatically reduces costs for webhook-based integrations
• Set callback.on to final instead of all to enable this mode

​

📊 Better Run Visibility

• Output counts are now visible directly in run details
• Know exactly how many results each run produced
• Clearer ROI tracking and performance monitoring

​

🔐 Clearer Error Messages

​

📝 What This Means for You

• More Reliable: LinkedIn authentication and Sales Navigator access issues are resolved
• Better Targeting: Richer profile data enables more personalized outreach
• Lower Integration Costs: One-shot callbacks can reduce automation platform costs significantly
• Clearer Insights: See exactly what each run produces with output counts

​

🚀 What’s New

​

🔔 Scheduled Run Tracking in Callbacks

{
  "scheduled_run_uid": "<uuid>"
}

​

✨ Enhanced Error Responses

​

Rate Limit Response Details

{
  "error": {
    "code": 429,
    "status": "Too Many Requests",
    "details": {
      "Retry-After": "60",
      "X-RateLimit-Limit": "2",
      "X-RateLimit-Reset": "1754402101",
      "X-RateLimit-Type": "/v1/actions"
    },
    "message": "Rate limit exceeded (/v1/actions)"
  }
}

​

🔧 Bug Fixes & Improvements

​

LinkedIn Post Extraction

• 🐛 Sanitize LinkedIn post URLs by stripping query parameters to avoid duplicate/mismatched post references and improve cache/canonicalization correctness

​

Identity and Authentication

• ✨ If a SN_ACCOUNT_UPGRADE error occurs, the related identity will be ignored for 60 seconds, reducing repeated failures and improving overall action reliability (later, this will apply only to managed identities)

​

Cross-Action Error Messaging

• ✨ Standardized error messages across actions for consistency, aligning error codes/messages and improving client-side parsing

​

📝 What This Means for You

• Better Debugging: Detailed error examples help identify issues faster
• Improved Rate Limit Handling: 429 responses with headers enable smarter retry logic
• Scheduled Run Correlation: New scheduled_run_uid field links callbacks to their schedule
• More Reliable Actions: Automatic identity cooldown on SN upgrade errors prevents cascading failures
• Cleaner Post URLs: Post extraction now handles URLs with query parameters correctly

​

🚀 What’s New

​

🔔 LinkedIn Invitations — Schema Improvements

​

Standardized Invitation Identifiers

• linkedin_invitation_id — String identifier for the invitation
• linkedin_invitation_urn — LinkedIn URN for stable reference

⚠️ Migration Note: If you’re using invitation actions, update your integrations to use the new field names.

​

✨ LinkedIn Post Activity — Author Information

• author — The person who shared/posted the content
• original_author — The original content creator (for reshares)

​

🔧 Bug Fixes & Improvements

​

LinkedIn Post Commenters

• 🐛 Fixed missing first_name and last_name fields — these were returning empty strings even when full_name was populated

​

LinkedIn Post Likers

• 🐛 Removed linkedin_company_id from output (field only applied to company likes)

​

LinkedIn Search Content

• ✨ Added linkedin_company_url to output

​

InMail & Message File Attachments

• 🐛 Fixed file validation for Base64-encoded attachments
• 🐛 Fixed filename extension validation regex

​

API Error Responses

• ✨ Added standardized error schemas: PaymentRequired (402), Forbidden (403), NotFound (404), UnprocessableEntity (422), TooManyRequests (429)

​

Pagination

• ✨ Updated default page size to 100 for improved throughput on applicable actions

​

📚 Documentation

• ✨ Added POST /runs/{run_uid}/cancel — Cancel an async/schedule run
• ✨ Added GET /runs/{run_uid}/status — Lightweight run status polling
• ✨ Added GET /runs/{run_uid}/outputs — Poll for run outputs without callbacks

​

🚀 What’s New

​

🔔 Improved Webhook Delivery Identification & Deduplication

​

📌 New Stable Callback Reference (callback_ref_uid)

{
  "callback_ref_uid": "<uuid>"
}

• Stable across retries
• Unique per callback event
• Designed specifically to allow safe deduplication on the client side

​

📌 New Delivery Attempt Headers

• Track each individual delivery attempt
• Log retries more easily
• Distinguish between event identity (stable) and delivery attempt identity (per retry)

​

📘 Why this matters

• Detect and safely ignore duplicate callbacks
• Correlate retries with the same logical event
• Debug delivery attempts via unique identifiers
• Keep payloads stable and idempotent

​

✅ Summary

• callback_ref_uid is now included in the payload → stable event identifier
• X-Callback-Ref → stable ID in headers
• X-Run-Callback → unique per delivery attempt
• Retries always resend the same payload, preserving the original run status and data

​

🔧 Action Fixes

​

LinkedIn Job Search

• 🐛 Handled missing job data by throwing a descriptive action error, preventing silent failures.

​

LinkedIn Post Likers Extraction

• 🐛 Removed linkedin_profile_handle from the output schema because the source does not provide it.

​

Company Enrichment

• 🐛 Fixed company domain resolution during company enrichment to return the correct domain.

​

🚀 Edges New Release

​

🔒 Improved LinkedIn Session Stability

• Enhanced IP Management: Implemented a new progressive IP rotation system that significantly improves LinkedIn session reliability
• Fewer Connection Errors: Reduced intermittent failures and reconnection issues during LinkedIn operations
• Better Error Handling: More reliable login, refresh, and checkpoint flows with improved retry logic
• Smoother Workflows: Users should experience fewer session-related interruptions and more stable automation runs

​

💰 Engagement Identities Billing Enhancements

• Improved Billing Accuracy: New buffer mechanism ensures more accurate usage tracking and billing for engagement identities
• Multiple Plan Tiers: Support for tiered pricing plans based on usage volume, providing better flexibility and cost optimization
• Better Timeframe Validation: Enhanced validation ensures billing stays within subscription timeframes for accurate charges
• Clearer Error Messages: Improved error messages when creating identities to distinguish between “No plan available” and “No more room in plan” scenarios

​

📊 Sales Navigator & LinkedIn Actions Improvements

• Increased Limits: Sales Navigator company employee search now supports up to 2,500 results (previously 1,000) per request
• Enhanced Profile Data: Company logo URLs are now included in profile experiences when extracting people data
• Fixed Post-Likers Actions: Resolved issues with post-likers actions when using “share” URLs as input
• Better Pagination: Fixed error 424 issues on multiple-output actions by preventing unnecessary pagination when no results are available
• Improved Post Commenters: Enhanced validation for post commenters extraction to handle edge cases more reliably

​

🔧 API & Automation Improvements

• Output Retrieval by Run UUID: You can now retrieve outputs directly by Run UUID, making it easier to access run results
• Better Workflow Support: Enhanced workflow schemas with improved support for optional steps and output anchoring
• Real Dates from IDs: Actions now return accurate dates when retrieving data by ID

​

🛠️ Platform Reliability

• Automated Data Retention: Implemented automated cleanup of old runs and usage data to maintain optimal platform performance
  • Runs older than 90 days are automatically archived
  • Usage records older than 5 days are cleaned up
  • This ensures faster queries and better overall system performance

​

📝 What This Means for You

• More Reliable Automations: LinkedIn actions should run more smoothly with fewer session interruptions
• Better Billing Accuracy: Engagement identities billing is now more precise and transparent
• Increased Capacity: Sales Navigator searches can now handle larger result sets
• Improved Developer Experience: Better error messages and API capabilities make integration easier
• Faster Performance: Automated data retention keeps the platform running smoothly over time

​

🚀 Edges New Release

• New Engagement Identities mode for running LinkedIn outreach actions without consuming credits
• Improved UI overall with updated components for better fluidity and user experience

​

💰 Engagement Identities Pricing & Billing

• New billing model: Engagement Identities are billed monthly based on peak usage
• Starting at $7.99/identity/month with dynamic pricing that decreases with volume
• Credit-free outreach: Run a comprehensive set of outreach actions (connect, message, follow, engage) without consuming credits
• Flexible usage: Convert existing identities to engagement mode or create new ones via API
• Live monitoring: Track current billing status and peak usage

​

🚀 Update on Extract LinkedIn People

• 👔 With the experiences parameter, we now retrieve only the first five companies’ experiences. The total number may vary depending on the profile. If you want more experiences, use the linkedin-extract-people-experiences endpoint.
• 💡 With the skills parameter, we now get only a few skills (one or two) — again, this can vary by profile. If you want more skills, use the linkedin-extract-people-skills endpoint.
• 📋 Both actions use the same input payload as linkedin-extract-people.
• ⚠️ Note: these two new actions share the same limit. We’ll define the daily and per-minute request limits in a future release.

​

🔧 Technical Updates

• Rate limit simplification: Simplified rate limiting system (plans-based rate limits will be introduced in the next release cycle)

​

✨ New Action

• Extract LinkedIn Received Invitations — New linkedin-extract-received-invitations action to extract invitations you’ve received on LinkedIn, including sender details, messages, and timestamps.

​

🔧 Improvements

• Enhanced LinkedIn Native Login: Improved stability with broader support for LinkedIn challenge handling, ensuring more reliable authentication flows.
• Better Profile Data Extraction: Enhanced “experiences” field parsing in the linkedin-extract-people action for more accurate profile information.
• Live Mode Enhancements: custom_data is now included in both responses and errors for live execution mode, improving compatibility with automation tools and making it easier to track and reconcile requests.

​

🚀 Edges New Release

• New Credit Consumption endpoint to track credit usage
• New Get Identity Limits endpoint to track limits usage per identity and action
• New Generate Login Links endpoint to create new login links for identities
• Improved documentation and examples in FAQ, Native Login, and LinkedIn Limits sections.

​

🔔 Enhanced Integration Webhooks

• New Event Type: Added AUTH_UPDATED webhook event for monitoring LinkedIn account level changes
• Enhanced Payload: Webhook data now includes:
  • name: LinkedIn account name
  • level: Account type (Classic, Sales Navigator, Premium, Recruiter Lite)
• Better Monitoring: Real-time notifications when users upgrade or change their LinkedIn account levels

​

📚 Documentation Improvements

• API Consistency: Updated endpoint descriptions from “List all” to “List” for better clarity
• LinkedIn Limitations: Added clear documentation about group member extraction limitations
• Sales Navigator: Enhanced filtering capabilities with updated OpenAPI specifications

​

🔧 Technical Updates

• Updated OpenAPI specifications with new Sales Navigator filters
• Improved API documentation consistency across all listing endpoints
• Enhanced error handling and limitation documentation

​

🚀 Edges v1 – Public Release

​

📦 TypeScript SDK

• Action execution (live, async, schedule)
• Identity & integration management
• Run tracking & callbacks

​

⚙️ New API Core

• Modular actions, identified by scope (e.g. linkedin-extract-people)
• Modern execution modes: live, async, schedule
• Strong separation between members (dashboard users) and identities (automated accounts)
• Robust pagination, rate limits and error tracing

​

👥 Identity-Centric Design

• Identities represent your automation accounts (e.g. a LinkedIn profile)
• Create and manage identities independently from workspace members
• Use native login or cookie-based authentication
• Monitor integration status with webhooks

​

🔁 Async, Schedule & Callbacks

• Run bulk actions at scale via the async mode
• Program runs to start later (schedule_at) or recurrently with cron via the schedule mode
• Provide a callback_url to get results pushed when ready
• Enrich callback payloads with your own custom_data to simplify reconciliation

​

✉️ Featured Actions

• LinkedIn Authentication, Extract, Search, Find, Intents, Messaging & Engage
• Sales Navigator Search, Metrics & Engage
• Recruiter Lite Search

​

🧠 Developer Experience First

• Full OpenAPI-based, comprehensive documentation
• Instant authentication with API keys
• Built-in account rotation logic and identity modes
• Tracking and observability with run UIDs, callbacks and callbacks api
• Fast iteration cycles