Skip to main content
POST
Hand a conversation over to a teammate

Authorizations

Authorization
string
header
required

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-SID
string
header
required

Team scope for tokens that do not carry one. Ignored when the token already names a team.

Path Parameters

sid
string
required

The one-to-one LinkedIn thread whose lead is handed over (is_group false, a LinkedIn channel on it).

Required string length: 18
Pattern: ^ub_cv_

Body

application/json

Request body of hand_over_conversation.

message
string
required

The introduction: the first message of the group, sent by the thread's sender profile, read by the lead and the teammate. Say who joins and why, e.g. "Jody, adding our co-founder Peter: he works with our agency clients and takes it from here."

Required string length: 1 - 8000
to_sender_profile_sid
string

The teammate as a sender profile of this workspace (ub_sp_...) with a LinkedIn account, other than the sender profile the thread runs on. Exactly one of this and to_target.

Required string length: 18
Pattern: ^ub_sp_
to_target
string

The teammate as a LinkedIn profile: a linkedin.com/in/, Sales Navigator or Recruiter link, a bare slug or a raw URN, resolved like resolve_conversation_counterpart. For a teammate with no sender profile; exactly one of this and to_sender_profile_sid.

Required string length: 2 - 512
title
string

A name for the LinkedIn group, max 100 chars; without one LinkedIn shows the members.

Maximum string length: 100

Response

action success envelope.

success
enum<boolean>
required
Available options:
true
operation
enum<string>
required
Available options:
action
action
string
required

kebab-case verb; matches the route segment.

item
object | null
required
result
object
required
meta
object
required