# nv.syncInbox

This action enables whole-inbox monitoring in Sales Navigator so you can poll every incoming conversation without syncing each person individually.

This action enables **whole-inbox monitoring** for your Sales Navigator inbox so you can [poll the inbox](/docs/monitoring-inbox) for messages across every conversation.

Unlike [`nv.syncConversation`](/docs/action-nv-sync-conversation), 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](/docs/monitoring-inbox).

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

## Constraints

> ⏺️ **Root Start:** allowed.

> ⬆️ **Parent Actions:** N/A.

> ⬇️ **Child Actions:** N/A.

## Parameters

```json
{
  "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:**

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

- `label` – included only if specified in the action parameters.

2. **Failed enabling:**

```json
{
  "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.
