Add participants to a group conversation
curl --request POST \
--url https://beta.getsales.io/unibox/v1/api/conversations/{sid}/add-participants \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Team-SID: <api-key>' \
--data '
{
"targets": [
"<string>"
]
}
'import requests
url = "https://beta.getsales.io/unibox/v1/api/conversations/{sid}/add-participants"
payload = { "targets": ["<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({targets: ['<string>']})
};
fetch('https://beta.getsales.io/unibox/v1/api/conversations/{sid}/add-participants', 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/conversations/{sid}/add-participants",
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([
'targets' => [
'<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/conversations/{sid}/add-participants"
payload := strings.NewReader("{\n \"targets\": [\n \"<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/unibox/v1/api/conversations/{sid}/add-participants")
.header("Authorization", "Bearer <token>")
.header("Team-SID", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"targets\": [\n \"<string>\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://beta.getsales.io/unibox/v1/api/conversations/{sid}/add-participants")
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 \"targets\": [\n \"<string>\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"operation": "action",
"action": "<string>",
"item": {
"sid": "<string>",
"team_sid": "<string>",
"agent_sid": "<string>",
"channel_account_refs": [
{
"channel": "linkedin",
"account_sid": "<string>",
"provider_thread_sid": "<string>"
}
],
"channels": [
"linkedin"
],
"is_group": true,
"title": "<string>",
"origin": "synced",
"state": "needs_you",
"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>"
},
"sender_profile_sid": "<string>",
"primary_person_sid": "<string>",
"scenario_key": "<string>",
"origin_workflow_sid": "<string>",
"agent_mode_override": "autopilot_ok",
"automation_ref": {
"workflow_sid": "<string>",
"workflow_name": "<string>",
"ai_agent_mode": "copilot",
"playtable_sid": "<string>"
},
"active_plan_sid": "<string>",
"dialog": {
"goal": {},
"stage": "rapport",
"needs": [
"<string>"
],
"qualification_answers": {},
"exchanges_used": 1,
"engaged_at": "<string>",
"objective_reached_at": "<string>",
"from": "engage",
"entry_scenario": "<string>",
"replies_without_fact": 1,
"offered_at": "<string>",
"followups_sent": 1,
"came_back": 1,
"ended_at": "<string>",
"outcome": "said_yes",
"last_facts": [
"<string>"
],
"skipped": [
"engage"
],
"last_move": "<string>",
"last_move_reason": "<string>"
},
"lead_evidence": {
"their_link_at": "<string>",
"confirmed_time_at": "<string>",
"handoff_after_reply_at": "<string>"
},
"agent_level": {
"scenario_key": "<string>",
"setting": "autopilot",
"level": "autopilot",
"condition": "<string>",
"condition_kind": "lead",
"run_sid": "<string>",
"decided_at": "<string>"
},
"lead_timezone": "<string>",
"auto_messages_used": 1,
"unread_count": 1,
"needs_reply": true,
"snoozed_until": "<string>",
"last_message_preview": "<string>",
"last_message_at": "<string>",
"first_outbound_at": "<string>",
"last_inbound_at": "<string>",
"merged_into_sid": "<string>",
"created_at": "<string>",
"updated_at": "<string>",
"deleted_at": "<string>"
},
"result": {
"added": [
{
"sid": "<string>",
"team_sid": "<string>",
"conversation_sid": "<string>",
"role": "counterpart",
"is_primary": true,
"display_name": "<string>",
"headline": "<string>",
"avatar_url": "<string>",
"ln_member_id": "<string>",
"ln_id": "<string>",
"sn_id": "<string>",
"recruiter_id": "<string>",
"ln_nickname": "<string>",
"email": "<string>",
"person_sid": "<string>",
"linked_at": "<string>",
"linked_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>"
}
],
"skipped": [
{
"target": "<string>",
"reason": "already_member"
}
]
},
"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>"
}
}{
"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>"
}
}conversations
Add participants to a group conversation
Add people to a LinkedIn GROUP thread (a conversation with is_group true). Each target is what a user would paste: a linkedin.com/in/ link, a Sales Navigator or Recruiter link, a bare slug or a raw URN; it resolves like resolve_conversation_counterpart but down to a profile URN, which is how gtm-api addresses a group member, so a playtables person known by member id alone sends the ladder on to the sender profile's connections, the corpus and the lite profile.
result.added lists the participants the thread gained (role group_member, in target order); result.skipped names each target left out with a reason: unresolvable (no rung knows the profile, or it has no URN), already_member. Nothing is refused for that. 409 not_a_group on a one-to-one thread: LinkedIn opens a NEW group for that, so start one with send_message {new_thread: {attendees: [...]}} and the counterpart among them. 409 thread_not_dispatched while the group's opening message is still queued (no gtm thread yet). 422 channel_not_connected when no live sender profile carries the thread's account. A target the resolve could not ask about refuses the whole call and adds nobody, never a skip as unresolvable: 429 (gtm_busy, or bucket_saturated with retry_after), 403 (gtm_access_lost, gtm_scope_missing), 503 (gtm_unavailable, gtm_bridge_unavailable, playtables_unavailable): try again later. gtm-api's 409 linkedin_refused on the add itself passes through.
Contract:
- MCP tool `add_conversation_participants`, registry package `mcp.unibox/conversations`, mount `unibox.threads`.
- Operation `action`, response envelope `action`.
- Flags: none.
POST
/
api
/
conversations
/
{sid}
/
add-participants
Add participants to a group conversation
curl --request POST \
--url https://beta.getsales.io/unibox/v1/api/conversations/{sid}/add-participants \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Team-SID: <api-key>' \
--data '
{
"targets": [
"<string>"
]
}
'import requests
url = "https://beta.getsales.io/unibox/v1/api/conversations/{sid}/add-participants"
payload = { "targets": ["<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({targets: ['<string>']})
};
fetch('https://beta.getsales.io/unibox/v1/api/conversations/{sid}/add-participants', 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/conversations/{sid}/add-participants",
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([
'targets' => [
'<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/conversations/{sid}/add-participants"
payload := strings.NewReader("{\n \"targets\": [\n \"<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/unibox/v1/api/conversations/{sid}/add-participants")
.header("Authorization", "Bearer <token>")
.header("Team-SID", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"targets\": [\n \"<string>\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://beta.getsales.io/unibox/v1/api/conversations/{sid}/add-participants")
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 \"targets\": [\n \"<string>\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"operation": "action",
"action": "<string>",
"item": {
"sid": "<string>",
"team_sid": "<string>",
"agent_sid": "<string>",
"channel_account_refs": [
{
"channel": "linkedin",
"account_sid": "<string>",
"provider_thread_sid": "<string>"
}
],
"channels": [
"linkedin"
],
"is_group": true,
"title": "<string>",
"origin": "synced",
"state": "needs_you",
"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>"
},
"sender_profile_sid": "<string>",
"primary_person_sid": "<string>",
"scenario_key": "<string>",
"origin_workflow_sid": "<string>",
"agent_mode_override": "autopilot_ok",
"automation_ref": {
"workflow_sid": "<string>",
"workflow_name": "<string>",
"ai_agent_mode": "copilot",
"playtable_sid": "<string>"
},
"active_plan_sid": "<string>",
"dialog": {
"goal": {},
"stage": "rapport",
"needs": [
"<string>"
],
"qualification_answers": {},
"exchanges_used": 1,
"engaged_at": "<string>",
"objective_reached_at": "<string>",
"from": "engage",
"entry_scenario": "<string>",
"replies_without_fact": 1,
"offered_at": "<string>",
"followups_sent": 1,
"came_back": 1,
"ended_at": "<string>",
"outcome": "said_yes",
"last_facts": [
"<string>"
],
"skipped": [
"engage"
],
"last_move": "<string>",
"last_move_reason": "<string>"
},
"lead_evidence": {
"their_link_at": "<string>",
"confirmed_time_at": "<string>",
"handoff_after_reply_at": "<string>"
},
"agent_level": {
"scenario_key": "<string>",
"setting": "autopilot",
"level": "autopilot",
"condition": "<string>",
"condition_kind": "lead",
"run_sid": "<string>",
"decided_at": "<string>"
},
"lead_timezone": "<string>",
"auto_messages_used": 1,
"unread_count": 1,
"needs_reply": true,
"snoozed_until": "<string>",
"last_message_preview": "<string>",
"last_message_at": "<string>",
"first_outbound_at": "<string>",
"last_inbound_at": "<string>",
"merged_into_sid": "<string>",
"created_at": "<string>",
"updated_at": "<string>",
"deleted_at": "<string>"
},
"result": {
"added": [
{
"sid": "<string>",
"team_sid": "<string>",
"conversation_sid": "<string>",
"role": "counterpart",
"is_primary": true,
"display_name": "<string>",
"headline": "<string>",
"avatar_url": "<string>",
"ln_member_id": "<string>",
"ln_id": "<string>",
"sn_id": "<string>",
"recruiter_id": "<string>",
"ln_nickname": "<string>",
"email": "<string>",
"person_sid": "<string>",
"linked_at": "<string>",
"linked_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>"
}
],
"skipped": [
{
"target": "<string>",
"reason": "already_member"
}
]
},
"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>"
}
}{
"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
The group thread (ub_cv_..., is_group true).
Required string length:
18Pattern:
^ub_cv_Body
application/json
Request body of add_conversation_participants.
1..20 people, each a profile link, a slug or a URN (never stored: parsed at the edge). Twenty is LinkedIn's cap for a group.
Required array length:
1 - 20 elementsRequired string length:
2 - 512Response
action success envelope.
Available options:
true Available options:
action kebab-case verb; matches the route segment.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes