Create a Custom alert
curl --request POST \
--url https://app.pipecorn.com/api/v2/alerts \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '
{
"name": "VP Sales in France",
"search_url": "https://www.linkedin.com/sales/search/people?query=(filters:List((type:CURRENT_TITLE,values:List((text:VP%20Sales,selectionType:INCLUDED)))))",
"frequency": "daily",
"webhook_url": "https://hooks.example.com/pipecorn"
}
'import requests
url = "https://app.pipecorn.com/api/v2/alerts"
payload = {
"name": "VP Sales in France",
"search_url": "https://www.linkedin.com/sales/search/people?query=(filters:List((type:CURRENT_TITLE,values:List((text:VP%20Sales,selectionType:INCLUDED)))))",
"frequency": "daily",
"webhook_url": "https://hooks.example.com/pipecorn"
}
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({
name: 'VP Sales in France',
search_url: 'https://www.linkedin.com/sales/search/people?query=(filters:List((type:CURRENT_TITLE,values:List((text:VP%20Sales,selectionType:INCLUDED)))))',
frequency: 'daily',
webhook_url: 'https://hooks.example.com/pipecorn'
})
};
fetch('https://app.pipecorn.com/api/v2/alerts', 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/alerts",
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([
'name' => 'VP Sales in France',
'search_url' => 'https://www.linkedin.com/sales/search/people?query=(filters:List((type:CURRENT_TITLE,values:List((text:VP%20Sales,selectionType:INCLUDED)))))',
'frequency' => 'daily',
'webhook_url' => 'https://hooks.example.com/pipecorn'
]),
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/alerts"
payload := strings.NewReader("{\n \"name\": \"VP Sales in France\",\n \"search_url\": \"https://www.linkedin.com/sales/search/people?query=(filters:List((type:CURRENT_TITLE,values:List((text:VP%20Sales,selectionType:INCLUDED)))))\",\n \"frequency\": \"daily\",\n \"webhook_url\": \"https://hooks.example.com/pipecorn\"\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/alerts")
.header("X-API-KEY", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"VP Sales in France\",\n \"search_url\": \"https://www.linkedin.com/sales/search/people?query=(filters:List((type:CURRENT_TITLE,values:List((text:VP%20Sales,selectionType:INCLUDED)))))\",\n \"frequency\": \"daily\",\n \"webhook_url\": \"https://hooks.example.com/pipecorn\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.pipecorn.com/api/v2/alerts")
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 \"name\": \"VP Sales in France\",\n \"search_url\": \"https://www.linkedin.com/sales/search/people?query=(filters:List((type:CURRENT_TITLE,values:List((text:VP%20Sales,selectionType:INCLUDED)))))\",\n \"frequency\": \"daily\",\n \"webhook_url\": \"https://hooks.example.com/pipecorn\"\n}"
response = http.request(request)
puts response.read_body{
"alert": {
"uuid": "3f6c2a1e-9b8d-4c1f-a2e3-5d6f7a8b9c0d",
"name": "VP Sales in France",
"alert_type": "CUSTOM_LEAD",
"frequency": "DAILY",
"active": true,
"webhook_url": "https://hooks.example.com/pipecorn",
"created_at": "2026-11-03T09:00:00.000Z",
"latest_search_at": "2026-11-03T09:00:01.000Z"
}
}Alerts
Create a Custom Alert
Track a Sales Navigator search and get its new results on every run
POST
/
alerts
Create a Custom alert
curl --request POST \
--url https://app.pipecorn.com/api/v2/alerts \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '
{
"name": "VP Sales in France",
"search_url": "https://www.linkedin.com/sales/search/people?query=(filters:List((type:CURRENT_TITLE,values:List((text:VP%20Sales,selectionType:INCLUDED)))))",
"frequency": "daily",
"webhook_url": "https://hooks.example.com/pipecorn"
}
'import requests
url = "https://app.pipecorn.com/api/v2/alerts"
payload = {
"name": "VP Sales in France",
"search_url": "https://www.linkedin.com/sales/search/people?query=(filters:List((type:CURRENT_TITLE,values:List((text:VP%20Sales,selectionType:INCLUDED)))))",
"frequency": "daily",
"webhook_url": "https://hooks.example.com/pipecorn"
}
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({
name: 'VP Sales in France',
search_url: 'https://www.linkedin.com/sales/search/people?query=(filters:List((type:CURRENT_TITLE,values:List((text:VP%20Sales,selectionType:INCLUDED)))))',
frequency: 'daily',
webhook_url: 'https://hooks.example.com/pipecorn'
})
};
fetch('https://app.pipecorn.com/api/v2/alerts', 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/alerts",
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([
'name' => 'VP Sales in France',
'search_url' => 'https://www.linkedin.com/sales/search/people?query=(filters:List((type:CURRENT_TITLE,values:List((text:VP%20Sales,selectionType:INCLUDED)))))',
'frequency' => 'daily',
'webhook_url' => 'https://hooks.example.com/pipecorn'
]),
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/alerts"
payload := strings.NewReader("{\n \"name\": \"VP Sales in France\",\n \"search_url\": \"https://www.linkedin.com/sales/search/people?query=(filters:List((type:CURRENT_TITLE,values:List((text:VP%20Sales,selectionType:INCLUDED)))))\",\n \"frequency\": \"daily\",\n \"webhook_url\": \"https://hooks.example.com/pipecorn\"\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/alerts")
.header("X-API-KEY", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"VP Sales in France\",\n \"search_url\": \"https://www.linkedin.com/sales/search/people?query=(filters:List((type:CURRENT_TITLE,values:List((text:VP%20Sales,selectionType:INCLUDED)))))\",\n \"frequency\": \"daily\",\n \"webhook_url\": \"https://hooks.example.com/pipecorn\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.pipecorn.com/api/v2/alerts")
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 \"name\": \"VP Sales in France\",\n \"search_url\": \"https://www.linkedin.com/sales/search/people?query=(filters:List((type:CURRENT_TITLE,values:List((text:VP%20Sales,selectionType:INCLUDED)))))\",\n \"frequency\": \"daily\",\n \"webhook_url\": \"https://hooks.example.com/pipecorn\"\n}"
response = http.request(request)
puts response.read_body{
"alert": {
"uuid": "3f6c2a1e-9b8d-4c1f-a2e3-5d6f7a8b9c0d",
"name": "VP Sales in France",
"alert_type": "CUSTOM_LEAD",
"frequency": "DAILY",
"active": true,
"webhook_url": "https://hooks.example.com/pipecorn",
"created_at": "2026-11-03T09:00:00.000Z",
"latest_search_at": "2026-11-03T09:00:01.000Z"
}
}Paste the URL of a LinkedIn Sales Navigator search, the same one you would paste in the app’s Custom signal:
- A people search (
https://www.linkedin.com/sales/search/people...) creates aCUSTOM_LEADalert. Each run is a lead search. - A company search (
https://www.linkedin.com/sales/search/company...) creates aCUSTOM_ACCOUNTalert. Each run is a company list.
daily, weekly or monthly (default daily). After the first run, each run only picks up the results Sales Navigator reports as new since the previous one. max_results (1 to 2500, default 2500) caps the first run only.
Get the new results
There are two ways to receive the results of each run:- Webhook. Pass
webhook_urland each run posts its results there when it finishes: lead runs post the same payload as People search, company runs the same payload as Create a List. For lead alerts,webhook_streaming: trueposts the leads one by one as they are found. - Polling. Call Retrieve an Alert with
sinceset to thechecked_atof your previous call. It returns only the runs created since then, each with aresults_urlto fetch its leads or companies. A run whosestatusis notfinishedyet is still running: fetch itsresults_urlagain later.
Requirements and limits
- Your LinkedIn account must be connected to Pipecorn with Sales Navigator. The search runs on that account.
- A Sales Navigator account holds at most 50 saved searches.
- Each alert counts against your plan’s alert limit.
- Lead runs enrich the leads they find and spend credits like People search.
Authorizations
Your API key
Body
application/json
Name of the alert
Example:
"VP Sales in France"
Sales Navigator search URL, starting with https://www.linkedin.com/sales/search/people (leads) or https://www.linkedin.com/sales/search/company (accounts)
Example:
"https://www.linkedin.com/sales/search/people?query=(filters:List((type:CURRENT_TITLE,values:List((text:VP%20Sales,selectionType:INCLUDED)))))"
How often the alert runs. Case-insensitive
Available options:
daily, weekly, monthly Maximum number of results the first run extracts. Later runs pick up every new result
Required range:
1 <= x <= 2500URL each run posts its results to when it finishes. Lead runs post the same payload as POST /leads; company runs post the same payload as POST /lists
Example:
"https://hooks.example.com/pipecorn"
Lead alerts only. When true, leads are posted to webhook_url one by one as they are found instead of once the run finishes
Response
The alert was created and its first run started
Show child attributes
Show child attributes
Was this page helpful?