Import
Import Connectors
Import LinkedIn connectors for referral opportunity discovery
POST
/
network
/
import
/
connectors
{
"connectors": [
{
"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"]
}
}
curl -X POST https://api.clustr-ai.com/api/public/network/import/connectors \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"connectors": [
{
"linkedin_url": "https://www.linkedin.com/in/john-doe",
"record_id": "CRM_12345",
"owner_email": "alice@company.com"
}
],
"webhook_url": "https://your-webhook.com/endpoint"
}'
import requests
requests.post(
"https://api.clustr-ai.com/api/public/network/import/connectors",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={
"connectors": [{"linkedin_url": "https://www.linkedin.com/in/john-doe"}],
"webhook_url": "https://your-webhook.com/endpoint",
},
)
await fetch("https://api.clustr-ai.com/api/public/network/import/connectors", {
method: "POST",
headers: { Authorization: "Bearer YOUR_API_KEY", "Content-Type": "application/json" },
body: JSON.stringify({
connectors: [{ linkedin_url: "https://www.linkedin.com/in/john-doe" }],
webhook_url: "https://your-webhook.com/endpoint",
}),
});
{
"success": true,
"data": {
"message": "Successfully queued prospects for processing (webhook registered)",
"job_id": "988f0602-1ddd-49ec-aef6-e0a6d680b5a5",
"stats": {
"total_submitted": 1,
"valid_processed": 1,
"invalid_urls": 0
}
}
}
{
"success": false,
"error": {
"message": "Invalid request body",
"code": "BAD_REQUEST"
}
}
{
"success": false,
"error": {
"message": "Invalid or missing API key",
"code": "UNAUTHORIZED"
}
}
Import connectors by LinkedIn URL. Connectors are the people whose
connections Clustr analyzes to find referral opportunities. Processing is asynchronous. Results come
via webhook or email.
Renamed. This endpoint was previously
POST /network/import/contacts and its body field was
contacts. Both still work, so existing integrations keep running. New integrations should use
/network/import/connectors with connectors. Send connectors or contacts, not both.Body
object[]
1–50 connectors to import (use this OR
linkedin_urls, not both).Show fields
Show fields
string
required
Profile URL. Must be
/in/ format, not /in/ACwAAA...string
Your CRM identifier (passed through to webhook)
string
Who owns this connector. They own everything it produces: the opportunities this import
finds, and the ones later imports find too. Must already be in your owner directory, or be
added with Create Owner first. To change it later without
reimporting, use Set Connector Owner.
string
Must match an existing tag in Settings
object[]
deprecated
Previous name for
connectors. Still accepted, same fields. Use connectors instead.string[]
Simple alternative: 1–50 LinkedIn URLs without metadata (use this OR
connectors, not both).string
Receives results when processing completes
string
Email for job completion notification
A notification email will be sent to this address. This is not the connector’s email.
integer
Cap per connector. Omit for unlimited.
boolean
default:"false"
Include engagement history in webhook response
object
Passed through unchanged to webhook response
object
{
"connectors": [
{
"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"]
}
}
curl -X POST https://api.clustr-ai.com/api/public/network/import/connectors \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"connectors": [
{
"linkedin_url": "https://www.linkedin.com/in/john-doe",
"record_id": "CRM_12345",
"owner_email": "alice@company.com"
}
],
"webhook_url": "https://your-webhook.com/endpoint"
}'
import requests
requests.post(
"https://api.clustr-ai.com/api/public/network/import/connectors",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={
"connectors": [{"linkedin_url": "https://www.linkedin.com/in/john-doe"}],
"webhook_url": "https://your-webhook.com/endpoint",
},
)
await fetch("https://api.clustr-ai.com/api/public/network/import/connectors", {
method: "POST",
headers: { Authorization: "Bearer YOUR_API_KEY", "Content-Type": "application/json" },
body: JSON.stringify({
connectors: [{ linkedin_url: "https://www.linkedin.com/in/john-doe" }],
webhook_url: "https://your-webhook.com/endpoint",
}),
});
{
"success": true,
"data": {
"message": "Successfully queued prospects for processing (webhook registered)",
"job_id": "988f0602-1ddd-49ec-aef6-e0a6d680b5a5",
"stats": {
"total_submitted": 1,
"valid_processed": 1,
"invalid_urls": 0
}
}
}
{
"success": false,
"error": {
"message": "Invalid request body",
"code": "BAD_REQUEST"
}
}
{
"success": false,
"error": {
"message": "Invalid or missing API key",
"code": "UNAUTHORIZED"
}
}
⌘I
{
"connectors": [
{
"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"]
}
}
curl -X POST https://api.clustr-ai.com/api/public/network/import/connectors \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"connectors": [
{
"linkedin_url": "https://www.linkedin.com/in/john-doe",
"record_id": "CRM_12345",
"owner_email": "alice@company.com"
}
],
"webhook_url": "https://your-webhook.com/endpoint"
}'
import requests
requests.post(
"https://api.clustr-ai.com/api/public/network/import/connectors",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={
"connectors": [{"linkedin_url": "https://www.linkedin.com/in/john-doe"}],
"webhook_url": "https://your-webhook.com/endpoint",
},
)
await fetch("https://api.clustr-ai.com/api/public/network/import/connectors", {
method: "POST",
headers: { Authorization: "Bearer YOUR_API_KEY", "Content-Type": "application/json" },
body: JSON.stringify({
connectors: [{ linkedin_url: "https://www.linkedin.com/in/john-doe" }],
webhook_url: "https://your-webhook.com/endpoint",
}),
});
{
"success": true,
"data": {
"message": "Successfully queued prospects for processing (webhook registered)",
"job_id": "988f0602-1ddd-49ec-aef6-e0a6d680b5a5",
"stats": {
"total_submitted": 1,
"valid_processed": 1,
"invalid_urls": 0
}
}
}
{
"success": false,
"error": {
"message": "Invalid request body",
"code": "BAD_REQUEST"
}
}
{
"success": false,
"error": {
"message": "Invalid or missing API key",
"code": "UNAUTHORIZED"
}
}