Update sender profile
curl --request PATCH \
--url https://beta.getsales.io/unibox/v1/api/sender-profiles/{sid} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Team-SID: <api-key>' \
--data '
{
"name": "<string>",
"label": "<string>",
"avatar_url": "<string>",
"assignee_user_sid": "<string>",
"linkedin_history_since": "<string>"
}
'import requests
url = "https://beta.getsales.io/unibox/v1/api/sender-profiles/{sid}"
payload = {
"name": "<string>",
"label": "<string>",
"avatar_url": "<string>",
"assignee_user_sid": "<string>",
"linkedin_history_since": "<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({
name: '<string>',
label: '<string>',
avatar_url: '<string>',
assignee_user_sid: '<string>',
linkedin_history_since: '<string>'
})
};
fetch('https://beta.getsales.io/unibox/v1/api/sender-profiles/{sid}', 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/unibox/v1/api/sender-profiles/{sid}",
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([
'name' => '<string>',
'label' => '<string>',
'avatar_url' => '<string>',
'assignee_user_sid' => '<string>',
'linkedin_history_since' => '<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/unibox/v1/api/sender-profiles/{sid}"
payload := strings.NewReader("{\n \"name\": \"<string>\",\n \"label\": \"<string>\",\n \"avatar_url\": \"<string>\",\n \"assignee_user_sid\": \"<string>\",\n \"linkedin_history_since\": \"<string>\"\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/unibox/v1/api/sender-profiles/{sid}")
.header("Authorization", "Bearer <token>")
.header("Team-SID", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"<string>\",\n \"label\": \"<string>\",\n \"avatar_url\": \"<string>\",\n \"assignee_user_sid\": \"<string>\",\n \"linkedin_history_since\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://beta.getsales.io/unibox/v1/api/sender-profiles/{sid}")
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 \"name\": \"<string>\",\n \"label\": \"<string>\",\n \"avatar_url\": \"<string>\",\n \"assignee_user_sid\": \"<string>\",\n \"linkedin_history_since\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"operation": "update",
"item": {
"sid": "<string>",
"team_sid": "<string>",
"name": "<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>"
},
"label": "<string>",
"linkedin_account_sid": "<string>",
"linkedin_source": "cloud",
"linkedin_status": "active",
"linkedin_status_reason": "<string>",
"linkedin_has_sn": true,
"linkedin_recruiter_status": "active",
"linkedin_history_since": "<string>",
"linkedin_history_scope": "all",
"email_account_sid": "<string>",
"avatar_url": "<string>",
"assignee_user_sid": "<string>",
"history_sync": {
"status": "pending",
"requested_at": "<string>",
"started_at": "<string>",
"finished_at": "<string>",
"threads_seen": 1,
"threads_imported": 1,
"messages_imported": 1,
"skipped": 1,
"synced_through": "<string>",
"error": "<string>"
},
"mailboxes": [
{
"email_account_sid": "<string>",
"address": "<string>",
"display_name": "<string>",
"provider": "<string>",
"status": "<string>",
"status_reason": "<string>",
"is_primary": true,
"sending_limits": {
"daily_limit": 123,
"min_interval_seconds": 123,
"sending_window": {}
},
"warmup_config": {
"enabled": true,
"ramp_start_daily": 123,
"ramp_step_per_day": 123,
"target_daily": 123
},
"signature_html": "<string>",
"bcc": [
"<string>"
],
"track_opens": true,
"track_clicks": true,
"email_tracking_domain_sid": "<string>",
"history_since": "<string>",
"history_scope": "all",
"connected_at": "<string>",
"synced_at": "<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>"
},
"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>"
}
}sender_profiles
Update sender profile
Partial edit of a sender profile’s config: name, label, avatar_url, assignee_user_sid, linkedin_history_since and linkedin_history_scope (the LinkedIn channel’s history window and import scope; an earlier day or a wider scope re-walks the account). Account refs are refused here (the channel verbs own them), and so is the channel state (linkedin_status, a mailbox status): a broken channel is fixed on the account. A sender profile cannot be paused: it has no status.
Contract:
- MCP tool
update_sender_profile, registry packagemcp.unibox/sender_profiles, mountunibox.sender-profiles. - Operation
update, response envelopeupdate. - Flags: none.
PATCH
/
api
/
sender-profiles
/
{sid}
Update sender profile
curl --request PATCH \
--url https://beta.getsales.io/unibox/v1/api/sender-profiles/{sid} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Team-SID: <api-key>' \
--data '
{
"name": "<string>",
"label": "<string>",
"avatar_url": "<string>",
"assignee_user_sid": "<string>",
"linkedin_history_since": "<string>"
}
'import requests
url = "https://beta.getsales.io/unibox/v1/api/sender-profiles/{sid}"
payload = {
"name": "<string>",
"label": "<string>",
"avatar_url": "<string>",
"assignee_user_sid": "<string>",
"linkedin_history_since": "<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({
name: '<string>',
label: '<string>',
avatar_url: '<string>',
assignee_user_sid: '<string>',
linkedin_history_since: '<string>'
})
};
fetch('https://beta.getsales.io/unibox/v1/api/sender-profiles/{sid}', 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/unibox/v1/api/sender-profiles/{sid}",
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([
'name' => '<string>',
'label' => '<string>',
'avatar_url' => '<string>',
'assignee_user_sid' => '<string>',
'linkedin_history_since' => '<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/unibox/v1/api/sender-profiles/{sid}"
payload := strings.NewReader("{\n \"name\": \"<string>\",\n \"label\": \"<string>\",\n \"avatar_url\": \"<string>\",\n \"assignee_user_sid\": \"<string>\",\n \"linkedin_history_since\": \"<string>\"\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/unibox/v1/api/sender-profiles/{sid}")
.header("Authorization", "Bearer <token>")
.header("Team-SID", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"<string>\",\n \"label\": \"<string>\",\n \"avatar_url\": \"<string>\",\n \"assignee_user_sid\": \"<string>\",\n \"linkedin_history_since\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://beta.getsales.io/unibox/v1/api/sender-profiles/{sid}")
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 \"name\": \"<string>\",\n \"label\": \"<string>\",\n \"avatar_url\": \"<string>\",\n \"assignee_user_sid\": \"<string>\",\n \"linkedin_history_since\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"operation": "update",
"item": {
"sid": "<string>",
"team_sid": "<string>",
"name": "<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>"
},
"label": "<string>",
"linkedin_account_sid": "<string>",
"linkedin_source": "cloud",
"linkedin_status": "active",
"linkedin_status_reason": "<string>",
"linkedin_has_sn": true,
"linkedin_recruiter_status": "active",
"linkedin_history_since": "<string>",
"linkedin_history_scope": "all",
"email_account_sid": "<string>",
"avatar_url": "<string>",
"assignee_user_sid": "<string>",
"history_sync": {
"status": "pending",
"requested_at": "<string>",
"started_at": "<string>",
"finished_at": "<string>",
"threads_seen": 1,
"threads_imported": 1,
"messages_imported": 1,
"skipped": 1,
"synced_through": "<string>",
"error": "<string>"
},
"mailboxes": [
{
"email_account_sid": "<string>",
"address": "<string>",
"display_name": "<string>",
"provider": "<string>",
"status": "<string>",
"status_reason": "<string>",
"is_primary": true,
"sending_limits": {
"daily_limit": 123,
"min_interval_seconds": 123,
"sending_window": {}
},
"warmup_config": {
"enabled": true,
"ramp_start_daily": 123,
"ramp_step_per_day": 123,
"target_daily": 123
},
"signature_html": "<string>",
"bcc": [
"<string>"
],
"track_opens": true,
"track_clicks": true,
"email_tracking_domain_sid": "<string>",
"history_since": "<string>",
"history_scope": "all",
"connected_at": "<string>",
"synced_at": "<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>"
},
"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.
Path Parameters
Sender profile sid (ub_sp_…).
Required string length:
18Pattern:
^ub_sp_Body
application/json
Request body of update_sender_profile.
New display persona name (1..255); connecting an account never renames the profile.
Required string length:
1 - 255null or an empty string clears the label.
Maximum string length:
255Display photo URL; on a sender profile with a LinkedIn account, the account's photo takes its place again at the next read.
Maximum string length:
2048null unassigns the operator.
Required string length:
18The LinkedIn history window; present with null = all history, now = only what arrives from this change on. An earlier day, or null, re-walks the account down to it (history_sync pending); a later day, or now, deletes nothing, only bounds later runs.
Pattern:
^(now|\d{4}-\d{2}-\d{2})$The LinkedIn import scope; present with null = playtable_people, the default. Back to all re-walks the account (history_sync pending) so the conversations the people-only scope kept out come in; playtable_people deletes nothing and narrows later runs.
Available options:
all, playtable_people 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.