nv.syncConversation

This action allows you to sync a conversation in Sales Navigator so you can start polling it.

Constraints

⏺️ Root Start: allowed, when personUrl parameter is provided.

⬆️ Parent Actions: st.openPersonPage, nv.openPersonPage.

⬇️ Child Actions: N/A.

Parameters

{
  "actionType": "nv.syncConversation",
  "label": "sync1",
  "personUrl": "https://www.linkedin.com/in/person1",
  "days": 14
}

• label (optional) – custom label for tracking this action in workflow completion.
• personUrl (required for root start, forbidden for parent start) – public or hashed LinkedIn URL of the person whose conversation you want to sync.
• days (optional) – how many days the conversation stays synchronized, from 1 to 90. Defaults to 30.

Syncing period

Synchronization is not permanent. The conversation is updated until the syncUntil moment returned by this action, counted from the moment the action starts running.

After that moment the conversation stops being updated, but nothing is deleted: polling keeps returning the messages collected so far, together with the past syncUntil value. To resume updates, run this action again for the same person — the accumulated history is preserved, and a new period starts.

A reply from the other person does not extend the period.

Result options

1. Successful syncing:

{
  "actionType": "nv.syncConversation",
  "label": "sync1",
  "success": true,
  "data": {
    "syncUntil": "2026-09-09T09:55:31.582Z"
  }
}

• label – included only if specified in the action parameters.
• data.syncUntil – moment when synchronization of this conversation stops.

2. Failed syncing:

{
  "actionType": "nv.syncConversation",
  "label": "sync1",
  "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.
  • personNotFound – provided URL is not an existing LinkedIn person.