`linkedin_ads_list_campaign_groups`

List LinkedIn Campaign Groups

Description

List LinkedIn Campaign Groups for an ad account. Campaign groups are the top-level organizational unit containing campaigns.

Read-onlyIdempotentOpen-world

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "linkedin_ads_list_campaign_groups",
    "arguments": {
      "account_id": "123456789",
      "reason": "User wants to see campaign groups"
    }
  }
}

hopkin linkedin campaign-groups list

Flag	Type	Required	Description
`--account`	`string`	Required	Ad account ID (numeric, without URN prefix).
`--status`	`array`	Optional	Filter by status. Defaults to [ACTIVE, PAUSED].
`--campaign-group-id`	`string`	Optional	Fetch a single campaign group by numeric ID.
`--campaign-group-ids`	`array`	Optional	Fetch specific campaign groups by numeric IDs (batch GET).
`--limit`	`integer`	Optional
`--cursor`	`string`	Optional
`--refresh`	`boolean`	Optional

{
  "mcpServers": {
    "linkedin-ads": {
      "url": "https://linkedin.mcp.hopkin.ai",
      "transport": "sse"
    }
  }
}

Parameters

Name	Type	Required	Description
`account_id`	`string`	Required	Ad account ID (numeric, without URN prefix).minLength: 1
`reason`	`string`	Required	Why this tool call is neededminLength: 1, maxLength: 500

Optional parameters (6)

Name	Type	Required	Description
`status`	`array`	Optional	Filter by status. Defaults to [ACTIVE, PAUSED].
`campaign_group_id`	`string`	Optional	Fetch a single campaign group by numeric ID.
`campaign_group_ids`	`array`	Optional	Fetch specific campaign groups by numeric IDs (batch GET).
`limit`	`integer`	Optional	min: 1, max: 100
`cursor`	`string`	Optional
`refresh`	`boolean`	Optional

Examples

List active groups

{
  "account_id": "123456789",
  "reason": "User wants to see campaign groups"
}

hopkin linkedin campaign-groups list --account 123456789

Filter by status

{
  "account_id": "123456789",
  "status": [
    "ACTIVE",
    "PAUSED"
  ],
  "reason": "Show active and paused campaign groups"
}

hopkin linkedin campaign-groups list --account 123456789 --status ACTIVE,PAUSED