Skip to main content
POST
/
network
/
import
/
contacts
{
  "contacts": [
    {
      "linkedin_url": "https://www.linkedin.com/in/john-doe",
      "record_id": "CRM_12345",
      "owner_email": "alice@company.com",
      "connector_tag": "Friend"
    }
  ],
  "webhook_url": "https://your-webhook.com/endpoint",
  "max_opportunities": 50,
  "full_history": true,
  "custom": {
    "your_field": "value"
  },
  "filters": {
    "confidence_score_ranges": ["80-100", "60-79"],
    "seniority_levels": ["high", "mid"]
  }
}

{
  "success": true,
  "data": {
    "message": "Successfully queued 1 contacts for processing",
    "job_id": "988f0602-1ddd-49ec-aef6-e0a6d680b5a5",
    "stats": {
      "total_submitted": 1,
      "valid_processed": 1,
      "invalid_urls": 0
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.clustr-ai.com/llms.txt

Use this file to discover all available pages before exploring further.

Import contacts by LinkedIn URL. Processing is asynchronous. Results come via webhook or email.

​
Body

​
contacts
object[]
1–50 contacts to import (use this OR linkedin_urls, not both).
​
linkedin_urls
string[]
Simple alternative: 1–50 LinkedIn URLs without metadata (use this OR contacts, not both).
​
webhook_url
string
Receives results when processing completes
​
completion_email
string
Email for job completion notification
A notification email will be sent to this address. This is not the contact’s email.
​
max_opportunities
integer
Cap per contact. Omit for unlimited.
​
full_history
boolean
default:"false"
Include engagement history in webhook response
​
custom
object
Passed through unchanged to webhook response
​
filters
object
{
  "contacts": [
    {
      "linkedin_url": "https://www.linkedin.com/in/john-doe",
      "record_id": "CRM_12345",
      "owner_email": "alice@company.com",
      "connector_tag": "Friend"
    }
  ],
  "webhook_url": "https://your-webhook.com/endpoint",
  "max_opportunities": 50,
  "full_history": true,
  "custom": {
    "your_field": "value"
  },
  "filters": {
    "confidence_score_ranges": ["80-100", "60-79"],
    "seniority_levels": ["high", "mid"]
  }
}

{
  "success": true,
  "data": {
    "message": "Successfully queued 1 contacts for processing",
    "job_id": "988f0602-1ddd-49ec-aef6-e0a6d680b5a5",
    "stats": {
      "total_submitted": 1,
      "valid_processed": 1,
      "invalid_urls": 0
    }
  }
}