Lists

Add items to list

Add people or companies to a list. Use this to populate your lists with contacts or accounts. Provide an array of identifiers (LinkedIn URLs, company domains, or Village IDs, the graph_id other tools return). Each identifier is resolved and added to the list. Returns detailed results for each item: successful additions include the created item, failures include error codes and messages. Duplicates are detected and reported.

post/v2/lists/{id}/items

Request

  • Base URL: https://api.village.ai
  • URL: https://api.village.ai/v2/lists/{id}/items
  • Auth: HTTP bearer

Path parameters

idstring required

List ID

Example:123

Request body

Example request

{
  "items": [
    {
      "identifier": "https://linkedin.com/in/john-doe",
      "type": "people"
    }
  ]
}

Response

Items processed

Changes

No recorded changes to this operation across all 1 revision of this API.