Update signal preferences
curl --request PATCH \
--url https://beta.getsales.io/signals/v1/api/signal-preferences \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Team-SID: <api-key>' \
--data '
{
"hidden_types": [],
"notify_types": [],
"sender_profile_sids": [
"<string>"
],
"toast_enabled": true,
"saved_views": [
{
"name": "<string>",
"id": "<string>",
"filter": {
"playtable_sid": "<string>",
"sender_profile_sids": [
"<string>"
],
"types": [],
"q": "<string>"
}
}
]
}
'import requests
url = "https://beta.getsales.io/signals/v1/api/signal-preferences"
payload = {
"hidden_types": [],
"notify_types": [],
"sender_profile_sids": ["<string>"],
"toast_enabled": True,
"saved_views": [
{
"name": "<string>",
"id": "<string>",
"filter": {
"playtable_sid": "<string>",
"sender_profile_sids": ["<string>"],
"types": [],
"q": "<string>"
}
}
]
}
headers = {
"Authorization": "Bearer <token>",
"Team-SID": "<api-key>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {
Authorization: 'Bearer <token>',
'Team-SID': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
hidden_types: [],
notify_types: [],
sender_profile_sids: ['<string>'],
toast_enabled: true,
saved_views: [
{
name: '<string>',
id: '<string>',
filter: {
playtable_sid: '<string>',
sender_profile_sids: ['<string>'],
types: [],
q: '<string>'
}
}
]
})
};
fetch('https://beta.getsales.io/signals/v1/api/signal-preferences', 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/signals/v1/api/signal-preferences",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'hidden_types' => [
],
'notify_types' => [
],
'sender_profile_sids' => [
'<string>'
],
'toast_enabled' => true,
'saved_views' => [
[
'name' => '<string>',
'id' => '<string>',
'filter' => [
'playtable_sid' => '<string>',
'sender_profile_sids' => [
'<string>'
],
'types' => [
],
'q' => '<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/signals/v1/api/signal-preferences"
payload := strings.NewReader("{\n \"hidden_types\": [],\n \"notify_types\": [],\n \"sender_profile_sids\": [\n \"<string>\"\n ],\n \"toast_enabled\": true,\n \"saved_views\": [\n {\n \"name\": \"<string>\",\n \"id\": \"<string>\",\n \"filter\": {\n \"playtable_sid\": \"<string>\",\n \"sender_profile_sids\": [\n \"<string>\"\n ],\n \"types\": [],\n \"q\": \"<string>\"\n }\n }\n ]\n}")
req, _ := http.NewRequest("PATCH", 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.patch("https://beta.getsales.io/signals/v1/api/signal-preferences")
.header("Authorization", "Bearer <token>")
.header("Team-SID", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"hidden_types\": [],\n \"notify_types\": [],\n \"sender_profile_sids\": [\n \"<string>\"\n ],\n \"toast_enabled\": true,\n \"saved_views\": [\n {\n \"name\": \"<string>\",\n \"id\": \"<string>\",\n \"filter\": {\n \"playtable_sid\": \"<string>\",\n \"sender_profile_sids\": [\n \"<string>\"\n ],\n \"types\": [],\n \"q\": \"<string>\"\n }\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://beta.getsales.io/signals/v1/api/signal-preferences")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Team-SID"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"hidden_types\": [],\n \"notify_types\": [],\n \"sender_profile_sids\": [\n \"<string>\"\n ],\n \"toast_enabled\": true,\n \"saved_views\": [\n {\n \"name\": \"<string>\",\n \"id\": \"<string>\",\n \"filter\": {\n \"playtable_sid\": \"<string>\",\n \"sender_profile_sids\": [\n \"<string>\"\n ],\n \"types\": [],\n \"q\": \"<string>\"\n }\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"operation": "update",
"item": {
"sid": "<string>",
"team_sid": "<string>",
"user_sid": "<string>",
"hidden_types": [
"<string>"
],
"notify_types": [
"<string>"
],
"sender_profile_scope": "all",
"sender_profile_sids": [
"<string>"
],
"toast_enabled": true,
"seen_at": "<string>",
"saved_views": [
{
"id": "<string>",
"name": "<string>",
"view": "needs_me",
"filter": {
"object_type": "person",
"playtable_sid": "<string>",
"sender_profile_sids": [
"<string>"
],
"types": [
"<string>"
],
"q": "<string>"
}
}
],
"created_at": "<string>",
"updated_at": "<string>"
},
"updated_fields": [
"<string>"
],
"previous_values": {},
"meta": {
"trace_id": "<string>",
"span_id": "<string>",
"timestamp": "<string>",
"duration_ms": 1,
"team_sid": "<string>",
"actor_type": "<string>"
},
"kept_fields": [
"<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>"
}
}signal_preferences
Update signal preferences
Change your own Signals page settings, a partial update: each field sent replaces the stored value. hidden_types and notify_types are whole lists of signal types: to stop or start hearing of one, read the row and send the list without or with it. sender_profile_scope all | mine | chosen, with sender_profile_sids for chosen; toast_enabled; saved_views, the whole list: stored views keep their ids, a new one gets one. seen_at is mark_signals_seen. Nothing editable is 422 nothing_to_update.
Contract:
- MCP tool
update_signal_preferences, registry packagemcp.signals/signal_preferences, mountsignals.website. - Operation
update, response envelopeupdate. - Flags: none.
PATCH
/
api
/
signal-preferences
Update signal preferences
curl --request PATCH \
--url https://beta.getsales.io/signals/v1/api/signal-preferences \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Team-SID: <api-key>' \
--data '
{
"hidden_types": [],
"notify_types": [],
"sender_profile_sids": [
"<string>"
],
"toast_enabled": true,
"saved_views": [
{
"name": "<string>",
"id": "<string>",
"filter": {
"playtable_sid": "<string>",
"sender_profile_sids": [
"<string>"
],
"types": [],
"q": "<string>"
}
}
]
}
'import requests
url = "https://beta.getsales.io/signals/v1/api/signal-preferences"
payload = {
"hidden_types": [],
"notify_types": [],
"sender_profile_sids": ["<string>"],
"toast_enabled": True,
"saved_views": [
{
"name": "<string>",
"id": "<string>",
"filter": {
"playtable_sid": "<string>",
"sender_profile_sids": ["<string>"],
"types": [],
"q": "<string>"
}
}
]
}
headers = {
"Authorization": "Bearer <token>",
"Team-SID": "<api-key>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {
Authorization: 'Bearer <token>',
'Team-SID': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
hidden_types: [],
notify_types: [],
sender_profile_sids: ['<string>'],
toast_enabled: true,
saved_views: [
{
name: '<string>',
id: '<string>',
filter: {
playtable_sid: '<string>',
sender_profile_sids: ['<string>'],
types: [],
q: '<string>'
}
}
]
})
};
fetch('https://beta.getsales.io/signals/v1/api/signal-preferences', 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/signals/v1/api/signal-preferences",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'hidden_types' => [
],
'notify_types' => [
],
'sender_profile_sids' => [
'<string>'
],
'toast_enabled' => true,
'saved_views' => [
[
'name' => '<string>',
'id' => '<string>',
'filter' => [
'playtable_sid' => '<string>',
'sender_profile_sids' => [
'<string>'
],
'types' => [
],
'q' => '<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/signals/v1/api/signal-preferences"
payload := strings.NewReader("{\n \"hidden_types\": [],\n \"notify_types\": [],\n \"sender_profile_sids\": [\n \"<string>\"\n ],\n \"toast_enabled\": true,\n \"saved_views\": [\n {\n \"name\": \"<string>\",\n \"id\": \"<string>\",\n \"filter\": {\n \"playtable_sid\": \"<string>\",\n \"sender_profile_sids\": [\n \"<string>\"\n ],\n \"types\": [],\n \"q\": \"<string>\"\n }\n }\n ]\n}")
req, _ := http.NewRequest("PATCH", 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.patch("https://beta.getsales.io/signals/v1/api/signal-preferences")
.header("Authorization", "Bearer <token>")
.header("Team-SID", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"hidden_types\": [],\n \"notify_types\": [],\n \"sender_profile_sids\": [\n \"<string>\"\n ],\n \"toast_enabled\": true,\n \"saved_views\": [\n {\n \"name\": \"<string>\",\n \"id\": \"<string>\",\n \"filter\": {\n \"playtable_sid\": \"<string>\",\n \"sender_profile_sids\": [\n \"<string>\"\n ],\n \"types\": [],\n \"q\": \"<string>\"\n }\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://beta.getsales.io/signals/v1/api/signal-preferences")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Team-SID"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"hidden_types\": [],\n \"notify_types\": [],\n \"sender_profile_sids\": [\n \"<string>\"\n ],\n \"toast_enabled\": true,\n \"saved_views\": [\n {\n \"name\": \"<string>\",\n \"id\": \"<string>\",\n \"filter\": {\n \"playtable_sid\": \"<string>\",\n \"sender_profile_sids\": [\n \"<string>\"\n ],\n \"types\": [],\n \"q\": \"<string>\"\n }\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"operation": "update",
"item": {
"sid": "<string>",
"team_sid": "<string>",
"user_sid": "<string>",
"hidden_types": [
"<string>"
],
"notify_types": [
"<string>"
],
"sender_profile_scope": "all",
"sender_profile_sids": [
"<string>"
],
"toast_enabled": true,
"seen_at": "<string>",
"saved_views": [
{
"id": "<string>",
"name": "<string>",
"view": "needs_me",
"filter": {
"object_type": "person",
"playtable_sid": "<string>",
"sender_profile_sids": [
"<string>"
],
"types": [
"<string>"
],
"q": "<string>"
}
}
],
"created_at": "<string>",
"updated_at": "<string>"
},
"updated_fields": [
"<string>"
],
"previous_values": {},
"meta": {
"trace_id": "<string>",
"span_id": "<string>",
"timestamp": "<string>",
"duration_ms": 1,
"team_sid": "<string>",
"actor_type": "<string>"
},
"kept_fields": [
"<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 update_signal_preferences.
The signal types the feed leaves out. Replaces the stored list as a set ([] shows every type); duplicates collapse, stored in the page's order.
A signal type: a ledger type (the type of search_activities) the Signals page lists, the website's first, then LinkedIn's, then email's.
Available options:
website_visited, website_key_page_visited, website_form_submitted, website_event, linkedin_connection_request_accepted, linkedin_message_replied, linkedin_inmail_replied, linkedin_invitation_received, linkedin_followed, linkedin_message_reacted, linkedin_message_deleted, linkedin_profile_viewed_us, linkedin_connection_removed, linkedin_blocked, linkedin_post_published, linkedin_birthday, linkedin_work_anniversary, linkedin_job_changed, email_opened, email_link_clicked, email_replied, email_bounced, email_unsubscribed, email_complained The signal types the user is told about (the badge and the toast). Replaces the stored list as a set ([] tells nothing): to add or drop one type, read the row and send the whole list.
A signal type: a ledger type (the type of search_activities) the Signals page lists, the website's first, then LinkedIn's, then email's.
Available options:
website_visited, website_key_page_visited, website_form_submitted, website_event, linkedin_connection_request_accepted, linkedin_message_replied, linkedin_inmail_replied, linkedin_invitation_received, linkedin_followed, linkedin_message_reacted, linkedin_message_deleted, linkedin_profile_viewed_us, linkedin_connection_removed, linkedin_blocked, linkedin_post_published, linkedin_birthday, linkedin_work_anniversary, linkedin_job_changed, email_opened, email_link_clicked, email_replied, email_bounced, email_unsubscribed, email_complained all | mine | chosen: whose sender profiles the feed starts on. Moving off chosen keeps sender_profile_sids.
Available options:
all, mine, chosen The chosen sender profiles (unibox sender profile sids, ub_sp_..., 18 characters), at most 200; duplicates collapse. Read when sender_profile_scope is chosen, where [] means every sender profile.
Maximum array length:
200Required string length:
18Pattern:
^ub_sp_false stops the toasts; the badge still counts.
The whole list of saved views, at most 20; replaces the stored one ([] clears it). Send the stored views with their ids to keep them.
Maximum array length:
20Show child attributes
Show child attributes
Response
update success envelope.
Available options:
true Available options:
update Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
The fields this write did not change because the person's own value stands on them (stamped person); read the item for what landed.