Create data source
curl --request POST \
--url https://beta.getsales.io/playtables/v1/api/data-sources \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Team-SID: <api-key>' \
--data '
{
"playtable_sid": "<string>",
"url": "<string>",
"name": "<string>",
"sender_profile_sid": "<string>",
"payload": {
"prompt": "<string>",
"filters": {},
"window": {
"days": 7
},
"relevance": {
"prompt": "<string>"
},
"collect": {
"reactions": true,
"comments": true,
"reposts": true
},
"company_sids": [
"<string>"
],
"company_filter": {},
"per_company_limit": 13,
"records_path": "<string>"
},
"field_mapping": [
{
"source": "<string>",
"target": "<string>",
"name": "<string>"
}
],
"tag_sids": [
"<string>"
],
"add_tags_to_duplicate": true,
"qualify": {
"on": true,
"criterion": "<string>"
}
}
'import requests
url = "https://beta.getsales.io/playtables/v1/api/data-sources"
payload = {
"playtable_sid": "<string>",
"url": "<string>",
"name": "<string>",
"sender_profile_sid": "<string>",
"payload": {
"prompt": "<string>",
"filters": {},
"window": { "days": 7 },
"relevance": { "prompt": "<string>" },
"collect": {
"reactions": True,
"comments": True,
"reposts": True
},
"company_sids": ["<string>"],
"company_filter": {},
"per_company_limit": 13,
"records_path": "<string>"
},
"field_mapping": [
{
"source": "<string>",
"target": "<string>",
"name": "<string>"
}
],
"tag_sids": ["<string>"],
"add_tags_to_duplicate": True,
"qualify": {
"on": True,
"criterion": "<string>"
}
}
headers = {
"Authorization": "Bearer <token>",
"Team-SID": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
Authorization: 'Bearer <token>',
'Team-SID': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
playtable_sid: '<string>',
url: '<string>',
name: '<string>',
sender_profile_sid: '<string>',
payload: {
prompt: '<string>',
filters: {},
window: {days: 7},
relevance: {prompt: '<string>'},
collect: {reactions: true, comments: true, reposts: true},
company_sids: ['<string>'],
company_filter: {},
per_company_limit: 13,
records_path: '<string>'
},
field_mapping: [{source: '<string>', target: '<string>', name: '<string>'}],
tag_sids: ['<string>'],
add_tags_to_duplicate: true,
qualify: {on: true, criterion: '<string>'}
})
};
fetch('https://beta.getsales.io/playtables/v1/api/data-sources', 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://beta.getsales.io/playtables/v1/api/data-sources",
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([
'playtable_sid' => '<string>',
'url' => '<string>',
'name' => '<string>',
'sender_profile_sid' => '<string>',
'payload' => [
'prompt' => '<string>',
'filters' => [
],
'window' => [
'days' => 7
],
'relevance' => [
'prompt' => '<string>'
],
'collect' => [
'reactions' => true,
'comments' => true,
'reposts' => true
],
'company_sids' => [
'<string>'
],
'company_filter' => [
],
'per_company_limit' => 13,
'records_path' => '<string>'
],
'field_mapping' => [
[
'source' => '<string>',
'target' => '<string>',
'name' => '<string>'
]
],
'tag_sids' => [
'<string>'
],
'add_tags_to_duplicate' => true,
'qualify' => [
'on' => true,
'criterion' => '<string>'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json",
"Team-SID: <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://beta.getsales.io/playtables/v1/api/data-sources"
payload := strings.NewReader("{\n \"playtable_sid\": \"<string>\",\n \"url\": \"<string>\",\n \"name\": \"<string>\",\n \"sender_profile_sid\": \"<string>\",\n \"payload\": {\n \"prompt\": \"<string>\",\n \"filters\": {},\n \"window\": {\n \"days\": 7\n },\n \"relevance\": {\n \"prompt\": \"<string>\"\n },\n \"collect\": {\n \"reactions\": true,\n \"comments\": true,\n \"reposts\": true\n },\n \"company_sids\": [\n \"<string>\"\n ],\n \"company_filter\": {},\n \"per_company_limit\": 13,\n \"records_path\": \"<string>\"\n },\n \"field_mapping\": [\n {\n \"source\": \"<string>\",\n \"target\": \"<string>\",\n \"name\": \"<string>\"\n }\n ],\n \"tag_sids\": [\n \"<string>\"\n ],\n \"add_tags_to_duplicate\": true,\n \"qualify\": {\n \"on\": true,\n \"criterion\": \"<string>\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Team-SID", "<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://beta.getsales.io/playtables/v1/api/data-sources")
.header("Authorization", "Bearer <token>")
.header("Team-SID", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"playtable_sid\": \"<string>\",\n \"url\": \"<string>\",\n \"name\": \"<string>\",\n \"sender_profile_sid\": \"<string>\",\n \"payload\": {\n \"prompt\": \"<string>\",\n \"filters\": {},\n \"window\": {\n \"days\": 7\n },\n \"relevance\": {\n \"prompt\": \"<string>\"\n },\n \"collect\": {\n \"reactions\": true,\n \"comments\": true,\n \"reposts\": true\n },\n \"company_sids\": [\n \"<string>\"\n ],\n \"company_filter\": {},\n \"per_company_limit\": 13,\n \"records_path\": \"<string>\"\n },\n \"field_mapping\": [\n {\n \"source\": \"<string>\",\n \"target\": \"<string>\",\n \"name\": \"<string>\"\n }\n ],\n \"tag_sids\": [\n \"<string>\"\n ],\n \"add_tags_to_duplicate\": true,\n \"qualify\": {\n \"on\": true,\n \"criterion\": \"<string>\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://beta.getsales.io/playtables/v1/api/data-sources")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Team-SID"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"playtable_sid\": \"<string>\",\n \"url\": \"<string>\",\n \"name\": \"<string>\",\n \"sender_profile_sid\": \"<string>\",\n \"payload\": {\n \"prompt\": \"<string>\",\n \"filters\": {},\n \"window\": {\n \"days\": 7\n },\n \"relevance\": {\n \"prompt\": \"<string>\"\n },\n \"collect\": {\n \"reactions\": true,\n \"comments\": true,\n \"reposts\": true\n },\n \"company_sids\": [\n \"<string>\"\n ],\n \"company_filter\": {},\n \"per_company_limit\": 13,\n \"records_path\": \"<string>\"\n },\n \"field_mapping\": [\n {\n \"source\": \"<string>\",\n \"target\": \"<string>\",\n \"name\": \"<string>\"\n }\n ],\n \"tag_sids\": [\n \"<string>\"\n ],\n \"add_tags_to_duplicate\": true,\n \"qualify\": {\n \"on\": true,\n \"criterion\": \"<string>\"\n }\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"operation": "create",
"item": {
"sid": "<string>",
"team_sid": "<string>",
"playtable_sid": "<string>",
"name": "<string>",
"type": "ai_search",
"object_type": "people",
"sender_profile_sid": "<string>",
"ingest_key": "<string>",
"payload": {
"platform": "linkedin",
"surface": "search",
"repeat": "hourly",
"mode": "create",
"target": "post",
"window": {
"days": 7
},
"relevance": {
"prompt": "<string>"
},
"collect": {
"reactions": true,
"comments": true,
"reposts": true
},
"posts": [
{
"urn": "<string>",
"title": "<string>",
"published_at": "<string>",
"verdict": "match",
"verdict_reason": "<string>"
}
]
},
"field_mapping": [
{
"source": "<string>",
"target_kind": "people_attribute",
"target": "<string>",
"name": "<string>"
}
],
"tag_sids": [
"<string>"
],
"qualify": {
"on": true,
"criterion": "<string>"
},
"on_duplicate": "skip",
"add_tags_to_duplicate": true,
"status": "draft",
"status_reason": "<string>",
"next_collect_at": "<string>",
"created_by": {
"actor_type": "user",
"actor_sid": "<string>",
"team_sid": "<string>",
"permissions": {},
"actor_name": "<string>",
"oauth_client_sid": "<string>",
"reason": "<string>",
"cluster_id": 123,
"trace_id": "<string>"
},
"deleted_by": {
"actor_type": "user",
"actor_sid": "<string>",
"team_sid": "<string>",
"permissions": {},
"actor_name": "<string>",
"oauth_client_sid": "<string>",
"reason": "<string>",
"cluster_id": 123,
"trace_id": "<string>"
},
"created_at": "<string>",
"updated_at": "<string>",
"deleted_at": "<string>"
},
"already_exists": true,
"meta": {
"trace_id": "<string>",
"span_id": "<string>",
"timestamp": "<string>",
"duration_ms": 1,
"team_sid": "<string>",
"actor_type": "<string>"
},
"ingest_url": "<string>"
}{
"success": false,
"error": {
"code": "validation_failed",
"message": "<string>",
"recoverable": true,
"suggestion": "<string>",
"field_errors": {},
"blockers": [
{
"type": "<string>",
"severity": "hard",
"description": "<string>",
"entity_sid": "<string>",
"resolution": "<string>",
"resolution_hint": "<string>",
"count": 123
}
],
"context": {}
},
"meta": {
"trace_id": "<string>",
"span_id": "<string>",
"timestamp": "<string>",
"duration_ms": 1,
"team_sid": "<string>",
"actor_type": "<string>"
}
}{
"success": false,
"error": {
"code": "validation_failed",
"message": "<string>",
"recoverable": true,
"suggestion": "<string>",
"field_errors": {},
"blockers": [
{
"type": "<string>",
"severity": "hard",
"description": "<string>",
"entity_sid": "<string>",
"resolution": "<string>",
"resolution_hint": "<string>",
"count": 123
}
],
"context": {}
},
"meta": {
"trace_id": "<string>",
"span_id": "<string>",
"timestamp": "<string>",
"duration_ms": 1,
"team_sid": "<string>",
"actor_type": "<string>"
}
}data_sources
Create data source
Create an ingestion source into a table. type says who runs it and is required: the same Sales Navigator link is a valid ai_search and a valid sender_search, so a link’s shape never decides.
ai_search: exactly one of url, payload.prompt or payload.filters; the pool runs it for credits, no sender. sender_search: sender_profile_sid plus url, unless payload.surface is my_network or messenger; payload.repeat reruns it. post_engagement: sender_profile_sid plus a post, profile or company page link (preview_post_engagement reads it back first); payload.window, relevance, collect and repeat tune it; every person lands with what they did. find_people: payload.company_sids and/or company_filter, plus a prompt or filters; always people. webhook: payload.records_path; the answer carries ingest_url (the credential: rotate to revoke). csv is refused: upload it, then import_data_source.
Refusals are 422, the reason in field_errors[field][0].rule: url needs_sender (only a Sales Navigator search runs on the pool: the rest is a sender_search), url post_engagement (a post link in a search kind), link_not_recognized, object_type or payload.target agreement, payload in, payload.collect required, and on sender_profile_sid linkedin_account_missing, sales_nav_required, recruiter_required or recruiter_signed_out. No dedup. When NOT: blocking identifiers (create_stoplist_entry); feeding people into outreach (workflow sources).
Contract:
- MCP tool
create_data_source, registry packagemcp.playtables/data_sources, mountplaytables.sources. - Operation
create, response envelopecreate. - Flags: none.
POST
/
api
/
data-sources
Create data source
curl --request POST \
--url https://beta.getsales.io/playtables/v1/api/data-sources \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Team-SID: <api-key>' \
--data '
{
"playtable_sid": "<string>",
"url": "<string>",
"name": "<string>",
"sender_profile_sid": "<string>",
"payload": {
"prompt": "<string>",
"filters": {},
"window": {
"days": 7
},
"relevance": {
"prompt": "<string>"
},
"collect": {
"reactions": true,
"comments": true,
"reposts": true
},
"company_sids": [
"<string>"
],
"company_filter": {},
"per_company_limit": 13,
"records_path": "<string>"
},
"field_mapping": [
{
"source": "<string>",
"target": "<string>",
"name": "<string>"
}
],
"tag_sids": [
"<string>"
],
"add_tags_to_duplicate": true,
"qualify": {
"on": true,
"criterion": "<string>"
}
}
'import requests
url = "https://beta.getsales.io/playtables/v1/api/data-sources"
payload = {
"playtable_sid": "<string>",
"url": "<string>",
"name": "<string>",
"sender_profile_sid": "<string>",
"payload": {
"prompt": "<string>",
"filters": {},
"window": { "days": 7 },
"relevance": { "prompt": "<string>" },
"collect": {
"reactions": True,
"comments": True,
"reposts": True
},
"company_sids": ["<string>"],
"company_filter": {},
"per_company_limit": 13,
"records_path": "<string>"
},
"field_mapping": [
{
"source": "<string>",
"target": "<string>",
"name": "<string>"
}
],
"tag_sids": ["<string>"],
"add_tags_to_duplicate": True,
"qualify": {
"on": True,
"criterion": "<string>"
}
}
headers = {
"Authorization": "Bearer <token>",
"Team-SID": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
Authorization: 'Bearer <token>',
'Team-SID': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
playtable_sid: '<string>',
url: '<string>',
name: '<string>',
sender_profile_sid: '<string>',
payload: {
prompt: '<string>',
filters: {},
window: {days: 7},
relevance: {prompt: '<string>'},
collect: {reactions: true, comments: true, reposts: true},
company_sids: ['<string>'],
company_filter: {},
per_company_limit: 13,
records_path: '<string>'
},
field_mapping: [{source: '<string>', target: '<string>', name: '<string>'}],
tag_sids: ['<string>'],
add_tags_to_duplicate: true,
qualify: {on: true, criterion: '<string>'}
})
};
fetch('https://beta.getsales.io/playtables/v1/api/data-sources', 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://beta.getsales.io/playtables/v1/api/data-sources",
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([
'playtable_sid' => '<string>',
'url' => '<string>',
'name' => '<string>',
'sender_profile_sid' => '<string>',
'payload' => [
'prompt' => '<string>',
'filters' => [
],
'window' => [
'days' => 7
],
'relevance' => [
'prompt' => '<string>'
],
'collect' => [
'reactions' => true,
'comments' => true,
'reposts' => true
],
'company_sids' => [
'<string>'
],
'company_filter' => [
],
'per_company_limit' => 13,
'records_path' => '<string>'
],
'field_mapping' => [
[
'source' => '<string>',
'target' => '<string>',
'name' => '<string>'
]
],
'tag_sids' => [
'<string>'
],
'add_tags_to_duplicate' => true,
'qualify' => [
'on' => true,
'criterion' => '<string>'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json",
"Team-SID: <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://beta.getsales.io/playtables/v1/api/data-sources"
payload := strings.NewReader("{\n \"playtable_sid\": \"<string>\",\n \"url\": \"<string>\",\n \"name\": \"<string>\",\n \"sender_profile_sid\": \"<string>\",\n \"payload\": {\n \"prompt\": \"<string>\",\n \"filters\": {},\n \"window\": {\n \"days\": 7\n },\n \"relevance\": {\n \"prompt\": \"<string>\"\n },\n \"collect\": {\n \"reactions\": true,\n \"comments\": true,\n \"reposts\": true\n },\n \"company_sids\": [\n \"<string>\"\n ],\n \"company_filter\": {},\n \"per_company_limit\": 13,\n \"records_path\": \"<string>\"\n },\n \"field_mapping\": [\n {\n \"source\": \"<string>\",\n \"target\": \"<string>\",\n \"name\": \"<string>\"\n }\n ],\n \"tag_sids\": [\n \"<string>\"\n ],\n \"add_tags_to_duplicate\": true,\n \"qualify\": {\n \"on\": true,\n \"criterion\": \"<string>\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Team-SID", "<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://beta.getsales.io/playtables/v1/api/data-sources")
.header("Authorization", "Bearer <token>")
.header("Team-SID", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"playtable_sid\": \"<string>\",\n \"url\": \"<string>\",\n \"name\": \"<string>\",\n \"sender_profile_sid\": \"<string>\",\n \"payload\": {\n \"prompt\": \"<string>\",\n \"filters\": {},\n \"window\": {\n \"days\": 7\n },\n \"relevance\": {\n \"prompt\": \"<string>\"\n },\n \"collect\": {\n \"reactions\": true,\n \"comments\": true,\n \"reposts\": true\n },\n \"company_sids\": [\n \"<string>\"\n ],\n \"company_filter\": {},\n \"per_company_limit\": 13,\n \"records_path\": \"<string>\"\n },\n \"field_mapping\": [\n {\n \"source\": \"<string>\",\n \"target\": \"<string>\",\n \"name\": \"<string>\"\n }\n ],\n \"tag_sids\": [\n \"<string>\"\n ],\n \"add_tags_to_duplicate\": true,\n \"qualify\": {\n \"on\": true,\n \"criterion\": \"<string>\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://beta.getsales.io/playtables/v1/api/data-sources")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Team-SID"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"playtable_sid\": \"<string>\",\n \"url\": \"<string>\",\n \"name\": \"<string>\",\n \"sender_profile_sid\": \"<string>\",\n \"payload\": {\n \"prompt\": \"<string>\",\n \"filters\": {},\n \"window\": {\n \"days\": 7\n },\n \"relevance\": {\n \"prompt\": \"<string>\"\n },\n \"collect\": {\n \"reactions\": true,\n \"comments\": true,\n \"reposts\": true\n },\n \"company_sids\": [\n \"<string>\"\n ],\n \"company_filter\": {},\n \"per_company_limit\": 13,\n \"records_path\": \"<string>\"\n },\n \"field_mapping\": [\n {\n \"source\": \"<string>\",\n \"target\": \"<string>\",\n \"name\": \"<string>\"\n }\n ],\n \"tag_sids\": [\n \"<string>\"\n ],\n \"add_tags_to_duplicate\": true,\n \"qualify\": {\n \"on\": true,\n \"criterion\": \"<string>\"\n }\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"operation": "create",
"item": {
"sid": "<string>",
"team_sid": "<string>",
"playtable_sid": "<string>",
"name": "<string>",
"type": "ai_search",
"object_type": "people",
"sender_profile_sid": "<string>",
"ingest_key": "<string>",
"payload": {
"platform": "linkedin",
"surface": "search",
"repeat": "hourly",
"mode": "create",
"target": "post",
"window": {
"days": 7
},
"relevance": {
"prompt": "<string>"
},
"collect": {
"reactions": true,
"comments": true,
"reposts": true
},
"posts": [
{
"urn": "<string>",
"title": "<string>",
"published_at": "<string>",
"verdict": "match",
"verdict_reason": "<string>"
}
]
},
"field_mapping": [
{
"source": "<string>",
"target_kind": "people_attribute",
"target": "<string>",
"name": "<string>"
}
],
"tag_sids": [
"<string>"
],
"qualify": {
"on": true,
"criterion": "<string>"
},
"on_duplicate": "skip",
"add_tags_to_duplicate": true,
"status": "draft",
"status_reason": "<string>",
"next_collect_at": "<string>",
"created_by": {
"actor_type": "user",
"actor_sid": "<string>",
"team_sid": "<string>",
"permissions": {},
"actor_name": "<string>",
"oauth_client_sid": "<string>",
"reason": "<string>",
"cluster_id": 123,
"trace_id": "<string>"
},
"deleted_by": {
"actor_type": "user",
"actor_sid": "<string>",
"team_sid": "<string>",
"permissions": {},
"actor_name": "<string>",
"oauth_client_sid": "<string>",
"reason": "<string>",
"cluster_id": 123,
"trace_id": "<string>"
},
"created_at": "<string>",
"updated_at": "<string>",
"deleted_at": "<string>"
},
"already_exists": true,
"meta": {
"trace_id": "<string>",
"span_id": "<string>",
"timestamp": "<string>",
"duration_ms": 1,
"team_sid": "<string>",
"actor_type": "<string>"
},
"ingest_url": "<string>"
}{
"success": false,
"error": {
"code": "validation_failed",
"message": "<string>",
"recoverable": true,
"suggestion": "<string>",
"field_errors": {},
"blockers": [
{
"type": "<string>",
"severity": "hard",
"description": "<string>",
"entity_sid": "<string>",
"resolution": "<string>",
"resolution_hint": "<string>",
"count": 123
}
],
"context": {}
},
"meta": {
"trace_id": "<string>",
"span_id": "<string>",
"timestamp": "<string>",
"duration_ms": 1,
"team_sid": "<string>",
"actor_type": "<string>"
}
}{
"success": false,
"error": {
"code": "validation_failed",
"message": "<string>",
"recoverable": true,
"suggestion": "<string>",
"field_errors": {},
"blockers": [
{
"type": "<string>",
"severity": "hard",
"description": "<string>",
"entity_sid": "<string>",
"resolution": "<string>",
"resolution_hint": "<string>",
"count": 123
}
],
"context": {}
},
"meta": {
"trace_id": "<string>",
"span_id": "<string>",
"timestamp": "<string>",
"duration_ms": 1,
"team_sid": "<string>",
"actor_type": "<string>"
}
}Authorizations
Access token issued by gs.service.id. Its access_identity claim carries team_sid, actor_sid and actor_type, and that team scope is authoritative.
Team scope for tokens that do not carry one. Ignored when the token already names a team.
Body
application/json
Request body of create_data_source.
Target table (pt_tb_…) receiving promoted objects. Required for every kind.
Required string length:
18Pattern:
^pt_tb_Required. ai_search | sender_search | post_engagement | find_people | webhook. csv is accepted by the shape rule and then refused with the way in: upload the file through upload-csv, then confirm it with import_data_source.
Available options:
ai_search, sender_search, post_engagement, find_people, csv, webhook LinkedIn link of an ai_search, sender_search or post_engagement: /search/results, /sales/search, /sales/lists, /talent/search?searchHistoryId=, /mynetwork, /messaging; post_engagement: /posts, /feed/update, lnkd.in, /in/{slug}, /company/{slug}.
Maximum string length:
2048What the rows become: people | company. Required for a description-mode ai_search. Elsewhere optional and checked for agreement with the link (or with the kind: find_people and webhook always bring people).
Available options:
people, company Defaults from the kind and its link ("Sales Navigator saved search", "My network", "AI search: ").
Required string length:
1 - 255The sender profile whose own LinkedIn account collects (ub_sp_); required for sender_search and post_engagement, prohibited elsewhere. Must be live, hold a LinkedIn account and the licence the link needs (Sales Navigator, or an active Recruiter session).
Required string length:
18Pattern:
^ub_sp_The kind's own keys: ai_search {prompt | filters}, sender_search {surface, repeat}, post_engagement {target, window, relevance, collect, repeat}, find_people {company_sids, company_filter, per_company_limit, prompt, filters}, webhook {records_path}.
Show child attributes
Show child attributes
Optional override for type=webhook (absent = attribute auto-detect at promotion); prohibited for the three search kinds, whose collector emits the canonical parser shape. A csv source gets its mapping at import.
Show child attributes
Show child attributes
Each tag must exist (cr_tg_…); applied to every promoted object.
Required string length:
18Pattern:
^cr_tg_Default 'skip'.
Available options:
skip, move Default false - merge tag_sids onto matched duplicates.
The source gate, "Check on save": {on, criterion}. A closed object (an unknown key is 422 rule invalid_qualify); on with no words is refused.
Show child attributes
Show child attributes
Response
create success envelope.
Available options:
true Available options:
create Show child attributes
Show child attributes
Show child attributes
Show child attributes
type=webhook only: {api_base}/external/ingest/{ingest_key} - the endpoint the customer CRM POSTs records to. The URL IS the credential: hand it to the user over a channel they trust, and rotate it to revoke.