Manage Sales Navigator lists

Use an account with Sales Navigator access. If the account has multiple contracts, use List Available Contracts and Select a Contract to activate the intended contract before working with its lists.

Select and browse a list

Workflow	Discover lists	Browse saved entries	Save an entry
Leads (people)	List Lead Lists	Browse a Lead List	Save a Lead to a List
Accounts (companies)	List Account Lists	Browse an Account List	Save an Account to a List

Keep the returned list ID and pass it as list_id. Browsing uses POST with search options in the body and pagination in the query; follow each operation's reference for its filters. Keep lead list IDs and account list IDs associated with their own list type.

List lead lists

const { data } = await linkedInApi.getSalesLeadLists({
  path: {
    account_id: "acc_123456789",
  },
  query: {
    limit: 20,
    offset: 0,
  },
});

data = linked_in_api.get_sales_lead_lists(
    account_id='acc_123456789',
    limit=20,
    offset=0,
)

curl --request GET \
  --url "https://api.unipile.com/v2/acc_123456789/linkedin/sales-navigator/lead-lists?limit=20&offset=0" \
  --header 'X-API-KEY: YOUR_API_KEY'

Browse a lead list

const { data } = await linkedInApi.browseSalesLeadList({
  path: {
    account_id: "acc_123456789",
    list_id: "list_id",
  },
  query: {
    limit: 20,
    offset: 0,
  },
  body: {},
});

data = linked_in_api.browse_sales_lead_list(
    account_id='acc_123456789',
    list_id='list_id',
    limit=20,
    offset=0,
    browse_sales_lead_list_request={},
)

curl --request POST \
  --url "https://api.unipile.com/v2/acc_123456789/linkedin/sales-navigator/lead-lists/list_id?limit=20&offset=0" \
  --header 'X-API-KEY: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{}'

List account lists

const { data } = await linkedInApi.getSalesAccountLists({
  path: {
    account_id: "acc_123456789",
  },
  query: {
    limit: 20,
    offset: 0,
  },
});

data = linked_in_api.get_sales_account_lists(
    account_id='acc_123456789',
    limit=20,
    offset=0,
)

curl --request GET \
  --url "https://api.unipile.com/v2/acc_123456789/linkedin/sales-navigator/account-lists?limit=20&offset=0" \
  --header 'X-API-KEY: YOUR_API_KEY'

Browse an account list

const { data } = await linkedInApi.browseSalesAccountList({
  path: {
    account_id: "acc_123456789",
    list_id: "list_id",
  },
  query: {
    limit: 20,
    offset: 0,
  },
  body: {},
});

data = linked_in_api.browse_sales_account_list(
    account_id='acc_123456789',
    list_id='list_id',
    limit=20,
    offset=0,
    browse_sales_account_list_request={},
)

curl --request POST \
  --url "https://api.unipile.com/v2/acc_123456789/linkedin/sales-navigator/account-lists/list_id?limit=20&offset=0" \
  --header 'X-API-KEY: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{}'

Save a lead

Resolve a person through Perform People Search, then send their user_id to an existing lead list.

For a company, use Perform Companies Search, then call Save an Account to a List with company_id. These methods add entries to existing lists; they do not create lists. Browse the list again to retrieve its current contents.

const { data } = await linkedInApi.saveSalesLeadToList({
  path: {
    account_id: "acc_123456789",
    list_id: "list_id",
  },
  body: {
    user_id: "user_id",
  },
});

data = linked_in_api.save_sales_lead_to_list(
    account_id='acc_123456789',
    list_id='list_id',
    save_sales_lead_to_list_request={
        "user_id": 'user_id'
    },
)

curl --request POST \
  --url "https://api.unipile.com/v2/acc_123456789/linkedin/sales-navigator/lead-lists/list_id/save" \
  --header 'X-API-KEY: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "user_id": "user_id"
}'

Save an account

const { data } = await linkedInApi.saveSalesAccountToList({
  path: {
    account_id: "acc_123456789",
    list_id: "list_id",
  },
  body: {
    company_id: "company_id",
  },
});

data = linked_in_api.save_sales_account_to_list(
    account_id='acc_123456789',
    list_id='list_id',
    save_sales_account_to_list_request={
        "company_id": 'company_id'
    },
)

curl --request POST \
  --url "https://api.unipile.com/v2/acc_123456789/linkedin/sales-navigator/account-lists/list_id/save" \
  --header 'X-API-KEY: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "company_id": "company_id"
}'