Skip to main content
POST
Start group conversation

Authorizations

Authorization
string
header
required

Access token issued by gtm.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.

Body

application/json

Request body of start_linkedin_group_conversation.

linkedin_account_sid
string
required

LinkedIn account sid (ln_ac_…).

Required string length: 18
Pattern: ^ln_ac_
attendees
object[]
required

2..20 other participants; each needs a URN.

Required array length: 2 - 20 elements
text
string
required

Opening message; 1..8000 chars.

Required string length: 1 - 8000
conversation_title
string | null

Optional group name, max 100 chars; omitted leaves the thread unnamed.

Maximum string length: 100
attachments
object[]

Each .path must be an https:// URL.

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
credits
object