Skip to main content
POST
/
user
/
paths
curl --request POST \
  --url https://api.village.do/v1/user/paths \
  --header 'Content-Type: application/json' \
  --header 'user-identifier: <user-identifier>' \
  --header 'x-access-token: <api-key>' \
  --data '
{
  "min_score": 7,
  "people": [
    "[email protected]",
    "linkedin.com/in/johndoe",
    "[email protected]"
  ]
}
'
{
  "success": true,
  "summary": {
    "processed": 3,
    "created": 2,
    "updated": 1,
    "failed": 0
  },
  "results": [
    {
      "identifier": "[email protected]",
      "status": "created",
      "person": {
        "id": "person-123",
        "name": "John Doe",
        "linkedin": "linkedin.com/in/johndoe"
      }
    },
    {
      "identifier": "[email protected]",
      "status": "updated",
      "person": {
        "id": "person-456",
        "name": "Jane Smith",
        "linkedin": null
      }
    }
  ]
}

Authorizations

​
x-access-token
string
header
required

JWT token obtained from /users/authorization endpoint

Headers

​
user-identifier
string
required

Specify the user making the request. This identifier should match the one you used when integrating the user with Village. Not needed when using user token authentication.

Body

application/json
​
people
(string | object)[]
required

Array of person identifiers. Can be Village IDs, emails, LinkedIn URLs, or objects with scores, or mixed. Supports flexible input formats.

Required array length: 1 - 100 elements

Simple identifier (Village ID, email, or LinkedIn URL)

Example:

"[email protected]"

​
min_score
number

Optional fallback score applied to all people without explicit score. Score Guidelines: 0.5-0.99 (Maybe; Not cold), 1-4 (Okay; Know each other; Have access to them), 4-7.49 (Good; Somewhat close), 7.5-9.99 (Very good; Close), 10 (Excellent; Closest)

Required range: 0 <= x <= 10
Example:

7

Response

Relationships imported successfully

​
success
boolean
required

Whether the operation was successful

Example:

true

​
summary
object
required

Summary of the import operation

​
results
object[]
required

Detailed results for each relationship