Find warm intros into an account

curl --request POST \
  --url https://app.pipecorn.com/api/v2/intents/accounts/warm_intros \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "company_linkedin_id": "1441",
  "webhook_url": "https://hooks.example.com/pipecorn/warm-intros",
  "persona_id": "8f2c1b7e-3a4d-4e5f-9a6b-1c2d3e4f5a6b",
  "job_titles": [
    "CFO",
    "VP Finance"
  ],
  "excluded_job_titles": [
    "Intern"
  ],
  "spotlights": [
    "SHARED_CONNECTION",
    "SHARED_EXPERIENCE"
  ],
  "limit": 10,
  "context": {
    "deal_id": "42"
  }
}
'

import requests

url = "https://app.pipecorn.com/api/v2/intents/accounts/warm_intros"

payload = {
    "company_linkedin_id": "1441",
    "webhook_url": "https://hooks.example.com/pipecorn/warm-intros",
    "persona_id": "8f2c1b7e-3a4d-4e5f-9a6b-1c2d3e4f5a6b",
    "job_titles": ["CFO", "VP Finance"],
    "excluded_job_titles": ["Intern"],
    "spotlights": ["SHARED_CONNECTION", "SHARED_EXPERIENCE"],
    "limit": 10,
    "context": { "deal_id": "42" }
}
headers = {
    "X-API-KEY": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    company_linkedin_id: '1441',
    webhook_url: 'https://hooks.example.com/pipecorn/warm-intros',
    persona_id: '8f2c1b7e-3a4d-4e5f-9a6b-1c2d3e4f5a6b',
    job_titles: ['CFO', 'VP Finance'],
    excluded_job_titles: ['Intern'],
    spotlights: ['SHARED_CONNECTION', 'SHARED_EXPERIENCE'],
    limit: 10,
    context: {deal_id: '42'}
  })
};

fetch('https://app.pipecorn.com/api/v2/intents/accounts/warm_intros', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.pipecorn.com/api/v2/intents/accounts/warm_intros",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'company_linkedin_id' => '1441',
    'webhook_url' => 'https://hooks.example.com/pipecorn/warm-intros',
    'persona_id' => '8f2c1b7e-3a4d-4e5f-9a6b-1c2d3e4f5a6b',
    'job_titles' => [
        'CFO',
        'VP Finance'
    ],
    'excluded_job_titles' => [
        'Intern'
    ],
    'spotlights' => [
        'SHARED_CONNECTION',
        'SHARED_EXPERIENCE'
    ],
    'limit' => 10,
    'context' => [
        'deal_id' => '42'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.pipecorn.com/api/v2/intents/accounts/warm_intros"

	payload := strings.NewReader("{\n  \"company_linkedin_id\": \"1441\",\n  \"webhook_url\": \"https://hooks.example.com/pipecorn/warm-intros\",\n  \"persona_id\": \"8f2c1b7e-3a4d-4e5f-9a6b-1c2d3e4f5a6b\",\n  \"job_titles\": [\n    \"CFO\",\n    \"VP Finance\"\n  ],\n  \"excluded_job_titles\": [\n    \"Intern\"\n  ],\n  \"spotlights\": [\n    \"SHARED_CONNECTION\",\n    \"SHARED_EXPERIENCE\"\n  ],\n  \"limit\": 10,\n  \"context\": {\n    \"deal_id\": \"42\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-KEY", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.pipecorn.com/api/v2/intents/accounts/warm_intros")
  .header("X-API-KEY", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"company_linkedin_id\": \"1441\",\n  \"webhook_url\": \"https://hooks.example.com/pipecorn/warm-intros\",\n  \"persona_id\": \"8f2c1b7e-3a4d-4e5f-9a6b-1c2d3e4f5a6b\",\n  \"job_titles\": [\n    \"CFO\",\n    \"VP Finance\"\n  ],\n  \"excluded_job_titles\": [\n    \"Intern\"\n  ],\n  \"spotlights\": [\n    \"SHARED_CONNECTION\",\n    \"SHARED_EXPERIENCE\"\n  ],\n  \"limit\": 10,\n  \"context\": {\n    \"deal_id\": \"42\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.pipecorn.com/api/v2/intents/accounts/warm_intros")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"company_linkedin_id\": \"1441\",\n  \"webhook_url\": \"https://hooks.example.com/pipecorn/warm-intros\",\n  \"persona_id\": \"8f2c1b7e-3a4d-4e5f-9a6b-1c2d3e4f5a6b\",\n  \"job_titles\": [\n    \"CFO\",\n    \"VP Finance\"\n  ],\n  \"excluded_job_titles\": [\n    \"Intern\"\n  ],\n  \"spotlights\": [\n    \"SHARED_CONNECTION\",\n    \"SHARED_EXPERIENCE\"\n  ],\n  \"limit\": 10,\n  \"context\": {\n    \"deal_id\": \"42\"\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "message": {
    "message": "Warm path search will begin shortly.",
    "request_id": "6f1c2a9e-4b7d-4c1e-9a2b-3d4e5f6a7b8c"
  }
}

POST

intents

accounts

warm_intros

Find warm intros into an account

curl --request POST \
  --url https://app.pipecorn.com/api/v2/intents/accounts/warm_intros \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "company_linkedin_id": "1441",
  "webhook_url": "https://hooks.example.com/pipecorn/warm-intros",
  "persona_id": "8f2c1b7e-3a4d-4e5f-9a6b-1c2d3e4f5a6b",
  "job_titles": [
    "CFO",
    "VP Finance"
  ],
  "excluded_job_titles": [
    "Intern"
  ],
  "spotlights": [
    "SHARED_CONNECTION",
    "SHARED_EXPERIENCE"
  ],
  "limit": 10,
  "context": {
    "deal_id": "42"
  }
}
'

import requests

url = "https://app.pipecorn.com/api/v2/intents/accounts/warm_intros"

payload = {
    "company_linkedin_id": "1441",
    "webhook_url": "https://hooks.example.com/pipecorn/warm-intros",
    "persona_id": "8f2c1b7e-3a4d-4e5f-9a6b-1c2d3e4f5a6b",
    "job_titles": ["CFO", "VP Finance"],
    "excluded_job_titles": ["Intern"],
    "spotlights": ["SHARED_CONNECTION", "SHARED_EXPERIENCE"],
    "limit": 10,
    "context": { "deal_id": "42" }
}
headers = {
    "X-API-KEY": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    company_linkedin_id: '1441',
    webhook_url: 'https://hooks.example.com/pipecorn/warm-intros',
    persona_id: '8f2c1b7e-3a4d-4e5f-9a6b-1c2d3e4f5a6b',
    job_titles: ['CFO', 'VP Finance'],
    excluded_job_titles: ['Intern'],
    spotlights: ['SHARED_CONNECTION', 'SHARED_EXPERIENCE'],
    limit: 10,
    context: {deal_id: '42'}
  })
};

fetch('https://app.pipecorn.com/api/v2/intents/accounts/warm_intros', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.pipecorn.com/api/v2/intents/accounts/warm_intros",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'company_linkedin_id' => '1441',
    'webhook_url' => 'https://hooks.example.com/pipecorn/warm-intros',
    'persona_id' => '8f2c1b7e-3a4d-4e5f-9a6b-1c2d3e4f5a6b',
    'job_titles' => [
        'CFO',
        'VP Finance'
    ],
    'excluded_job_titles' => [
        'Intern'
    ],
    'spotlights' => [
        'SHARED_CONNECTION',
        'SHARED_EXPERIENCE'
    ],
    'limit' => 10,
    'context' => [
        'deal_id' => '42'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.pipecorn.com/api/v2/intents/accounts/warm_intros"

	payload := strings.NewReader("{\n  \"company_linkedin_id\": \"1441\",\n  \"webhook_url\": \"https://hooks.example.com/pipecorn/warm-intros\",\n  \"persona_id\": \"8f2c1b7e-3a4d-4e5f-9a6b-1c2d3e4f5a6b\",\n  \"job_titles\": [\n    \"CFO\",\n    \"VP Finance\"\n  ],\n  \"excluded_job_titles\": [\n    \"Intern\"\n  ],\n  \"spotlights\": [\n    \"SHARED_CONNECTION\",\n    \"SHARED_EXPERIENCE\"\n  ],\n  \"limit\": 10,\n  \"context\": {\n    \"deal_id\": \"42\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-KEY", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.pipecorn.com/api/v2/intents/accounts/warm_intros")
  .header("X-API-KEY", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"company_linkedin_id\": \"1441\",\n  \"webhook_url\": \"https://hooks.example.com/pipecorn/warm-intros\",\n  \"persona_id\": \"8f2c1b7e-3a4d-4e5f-9a6b-1c2d3e4f5a6b\",\n  \"job_titles\": [\n    \"CFO\",\n    \"VP Finance\"\n  ],\n  \"excluded_job_titles\": [\n    \"Intern\"\n  ],\n  \"spotlights\": [\n    \"SHARED_CONNECTION\",\n    \"SHARED_EXPERIENCE\"\n  ],\n  \"limit\": 10,\n  \"context\": {\n    \"deal_id\": \"42\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.pipecorn.com/api/v2/intents/accounts/warm_intros")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"company_linkedin_id\": \"1441\",\n  \"webhook_url\": \"https://hooks.example.com/pipecorn/warm-intros\",\n  \"persona_id\": \"8f2c1b7e-3a4d-4e5f-9a6b-1c2d3e4f5a6b\",\n  \"job_titles\": [\n    \"CFO\",\n    \"VP Finance\"\n  ],\n  \"excluded_job_titles\": [\n    \"Intern\"\n  ],\n  \"spotlights\": [\n    \"SHARED_CONNECTION\",\n    \"SHARED_EXPERIENCE\"\n  ],\n  \"limit\": 10,\n  \"context\": {\n    \"deal_id\": \"42\"\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "message": {
    "message": "Warm path search will begin shortly.",
    "request_id": "6f1c2a9e-4b7d-4c1e-9a2b-3d4e5f6a7b8c"
  }
}

Give it a company and the people you want to reach there. It returns those decision makers and, for each one, your 1st-degree connections who can introduce you, with the same paths, shared experiences and relationship strength as Find connections. Use it when a deal opens from outbound or inbound: before the first meeting, you know who can vouch for you inside the account.

How it works

A Sales Navigator search finds the people working at the company today who match your persona_id, or your job_titles / excluded_job_titles, and who are in your 2nd-degree network: someone you know knows them.
For up to limit of them, Pipecorn looks up your warm paths, as Find connections does, using the spotlights you pick (default SHARED_CONNECTION).
The result is posted to your webhook_url, decision makers with the strongest warm path first.

It runs in the background: the response only holds a request_id. Expect about a minute for 10 decision makers.

Example request

{
  "company_linkedin_id": "1441",
  "job_titles": ["CFO", "VP Finance"],
  "spotlights": ["SHARED_CONNECTION", "SHARED_EXPERIENCE"],
  "limit": 10,
  "webhook_url": "https://hooks.example.com/pipecorn/warm-intros",
  "context": { "deal_id": "42" }
}

company_linkedin_id is the numeric LinkedIn company id. Get it from the linkedin_id of Enrich account if you only have a domain or a URL.

Example response

{
  "message": {
    "message": "Warm path search will begin shortly.",
    "request_id": "6f1c2a9e-4b7d-4c1e-9a2b-3d4e5f6a7b8c"
  }
}

Webhook payload

{
  "request_id": "6f1c2a9e-4b7d-4c1e-9a2b-3d4e5f6a7b8c",
  "context": { "deal_id": "42" },
  "status": "completed",
  "company_linkedin_id": "1441",
  "total_count": 4,
  "decision_makers": [
    {
      "full_name": "Grace Hopper",
      "headline": "CFO at Acme",
      "current_title": "CFO",
      "current_company": "Acme",
      "degree": 2,
      "linkedin_id": "ACwAAAgrace",
      "sales_navigator_url": "https://www.linkedin.com/sales/lead/ACwAAAgrace,NAME_SEARCH,ab12/",
      "warm_paths": {
        "total": 2,
        "totals_by_spotlight": { "SHARED_CONNECTION": 1, "SHARED_EXPERIENCE": 1 },
        "connections": [
          {
            "full_name": "Jane Doe",
            "paths": [{ "type": "SHARED_CONNECTION", "reason": "You both know Ada Lovelace" }],
            "shared_experiences": [
              { "company_id": "1035", "company": "Sellsy", "overlap_months": 18, "approximate_dates": false, "same_location": true, "company_size": 45 }
            ],
            "relationship_strength": { "score": 7, "level": "strong" }
          }
        ]
      }
    }
  ]
}

request_id matches the one returned when you started the search, and context is the object you sent, untouched.
total_count is the number of matching decision makers on Sales Navigator; at most limit are looked up.
warm_paths has the shape of the Find connections response. When LinkedIn can’t process one decision maker, it carries an error message instead.
When the search fails as a whole, status is failed and error says why, e.g. an expired LinkedIn session or a LinkedIn rate limit.

Requirements

A connected LinkedIn account with Sales Navigator. Without it the endpoint returns 422.
persona_id, when given, must be one of your personas (see GET /personas).

Notes

Doesn’t consume credits.
limit defaults to 10 and goes up to 25. Each decision maker costs a few Sales Navigator lookups, so keep it small.

Rate Limits

1 request per second per user, on top of your plan’s per-minute limit (see Rate Limiting).

Authorizations

X-API-KEY

string

header

required

Body

application/json

company_linkedin_id

string

required

Numeric LinkedIn company id of the account (the linkedin_id returned by POST /accounts/single_enrich). A number is accepted too.

Pattern: ^\d+$

Example:

"1441"

webhook_url

string<uri>

required

URL that receives the result as a POST once the search is done.

Example:

"https://hooks.example.com/pipecorn/warm-intros"

persona_id

string<uuid>

Optional. Id of one of your personas (see GET /personas). Its job titles, locations, industries and company sizes select the decision makers. Cannot be combined with job_titles or excluded_job_titles.

Example:

"8f2c1b7e-3a4d-4e5f-9a6b-1c2d3e4f5a6b"

job_titles

string[]

Optional. Keep only decision makers whose current title matches one of these. Use it instead of persona_id.

Example:

["CFO", "VP Finance"]

excluded_job_titles

string[]

Optional. Drop people whose current title matches one of these. Requires job_titles.

Example:

["Intern"]

spotlights

enum<string>[]

Optional. Kinds of warm path to look for. SHARED_CONNECTION: your connection is connected to the target. SHARED_EXPERIENCE: they worked at the same company. SHARED_EDUCATION: same school. SHARED_GROUP: same LinkedIn group. Each kind runs one more Sales Navigator lookup. TeamLink is not supported.

Minimum array length: 1

Available options:

SHARED_CONNECTION,

SHARED_EXPERIENCE,

SHARED_EDUCATION,

SHARED_GROUP

Example:

["SHARED_CONNECTION", "SHARED_EXPERIENCE"]

limit

integer

default:10

Maximum number of decision makers to look up.

Required range: 1 <= x <= 25

Example:

10

context

object

Optional. Any JSON object, sent back untouched in the webhook payload (e.g. your CRM deal id).

Example:

{ "deal_id": "42" }

Response

Search started. The result is posted to webhook_url.

message

object

Show child attributes

Overview

Leads (People)

Accounts (Companies)

Waterfall Enrichment

Signals

Searches

Personas

Lists

Miscellaneous

API Reference

Find warm intros into an account

How it works

Example request

Example response

Webhook payload

Requirements

Notes

Rate Limits

Authorizations

Body

Response

​How it works

​Example request

​Example response

​Webhook payload

​Requirements

​Notes

​Rate Limits

Authorizations

Body

Response

How it works

Example request

Example response

Webhook payload

Requirements

Notes

Rate Limits