User

Import Relationships

Import manual relationships to expand your network graph. Use this to add people you know but aren't connected to digitally. Provide email addresses or LinkedIn URLs with optional relationship scores (0-10, defaulting to 5). Higher scores indicate stronger relationships. Maximum 1000 people per request. Returns: summary counts and individual results showing created, updated, or failed imports.

post/v2/user/relationships

Request

Base URL: https://api.village.ai
URL: https://api.village.ai/v2/user/relationships
Auth: HTTP bearer

Request body

min_scorenumber

Default score for relationships without explicit score (0-10). Defaults to 5.

unhideboolean

Also bring back contacts the user hid. The Village app sets it when the user writes a contact again; automated imports leave it off so hidden contacts stay hidden.

Example request

{
  "people": [
    "john@example.com",
    "https://linkedin.com/in/janedoe",
    {
      "identifier": "mike@company.com",
      "score": 8
    }
  ],
  "min_score": 5
}

Response

Relationships imported successfully

Example response

{
  "data": {
    "summary": {
      "processed": 10,
      "created": 7,
      "updated": 2,
      "failed": 1
    },
    "results": [
      {
        "identifier": "john@example.com",
        "status": "created",
        "person": {
          "id": "person_abc123",
          "name": "John Doe",
          "linkedin": "https://linkedin.com/in/johndoe"
        },
        "error": {
          "code": "PERSON_NOT_FOUND",
          "message": "Could not find or create person with this identifier"
        }
      }
    ]
  }
}

Changes

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