Skip to main content
POST
Append mass-action items

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.

Path Parameters

sid
string
required

Mass-action sid (ma_ac_...).

Required string length: 18
Pattern: ^ma_ac_

Body

application/json

Request body of append_mass_action_items.

identities
object[]
required

Payload-kind leads. Identity fields (ln_member_id / ln_id / sn_id / company_ln_id / nickname) are the dedup axis; any other key rides along as per-target extras the plan steps can read. A lead the run's connect, message or follow step cannot reach (no URN and no slug; a message may name a linkedin_conversation_sid instead) refuses the batch with 422 target_identity_required on identities.{i}, as the preview refuses such a target: those steps send to a URN, or to a slug they resolve when they run. A run whose LinkedIn sender cannot send right now (signed out, parked by the subscription, lent out, gone from the team) takes no leads: 409 sender_not_ready, with context.linkedin_account_sid, context.state and context.detail naming the way out.

Required array length: 1 - 100 elements

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