nv.syncInbox

This action enables whole-inbox monitoring for your Sales Navigator inbox so you can poll the inbox for messages across every conversation.

Unlike nv.syncConversation, which watches a single person's conversation, nv.syncInbox starts tracking all incoming Sales Navigator threads. Run it once per account. After it succeeds, new messages become available through the inbox polling endpoint.

💡 Only messages that arrive after inbox sync is enabled are captured. History predating the moment you enable it is not imported.

This action only switches monitoring on: it records the setting and returns. It does not browse your inbox and does not open anyone's profile. The messages themselves are picked up afterwards by a sync that runs periodically, so the first ones appear on the next sync rather than the moment the action completes.

Note: When that sync finds new messages in a thread – including messages you send yourself – it opens the profile page of the other participant in that thread to resolve their public URL – but only when Linked API does not already know it, so a person is visited once, which is what fills personPublicUrl on the messages you poll or receive by webhook. Those visits are made from your own account, and such a visit is visible to the person whose profile is opened.

Constraints

⏺️ Root Start: allowed.

⬆️ Parent Actions: N/A.

⬇️ Child Actions: N/A.

Parameters

{
  "actionType": "nv.syncInbox",
  "label": "enableNvInbox"
}

• label (optional) – custom label for tracking this action in workflow completion.

This action takes no other parameters.

Result options

1. Successful enabling:

{
  "actionType": "nv.syncInbox",
  "label": "enableNvInbox",
  "success": true
}

• label – included only if specified in the action parameters.

2. Failed enabling:

{
  "actionType": "nv.syncInbox",
  "label": "enableNvInbox",
  "success": false,
  "error": {
    "type": "noSalesNavigator",
    "message": "Your account does not have Sales Navigator subscription."
  }
}

• label – included only if specified in the action parameters.
• error.type – enum with the following possible values:
  • noSalesNavigator – your account does not have Sales Navigator subscription.