Get LinkedIn Organizations

Fetch the LinkedIn Organizations (Company Pages) AND Ad Accounts the user can manage.

IMPORTANT: Call this tool during campaign creation discovery phase to get both organization_id AND account_id.

What this tool does:

Queries LinkedIn for all Company Pages the user has admin access to
Queries LinkedIn for all Ad Accounts the user can access
Returns organization IDs, names, AND ad account IDs
No parameters required - uses connected LinkedIn account

Returns:

List of organizations with ID, name, and LinkedIn URL
List of ad accounts with ID, name, status, and linked organization
Both IDs needed for different operations

Use this tool to:

Get the organization_id automatically (no need to ask user!)
Get the account_id for asset discovery (required for finding images/videos!)
Verify user has access to a Company Page
Find which page to use for Sponsored Content

After getting organizations & accounts:

Use the account_id in discover_linkedin_assets to find existing images/videos
Use the organization_id in whichever campaign creation tool the user selected:
- create_linkedin_image_campaign (Single Image)
- create_linkedin_video_campaign (Video)
- create_linkedin_carousel_campaign (Carousel)
- create_linkedin_text_campaign (Text Ad)
Assets are tied to ad accounts, not organizations - that’s why account_id is needed

Execution time: 2-3 seconds

POST

api

tools

get_linkedin_organizations

execute

Get LinkedIn Organizations

curl --request POST \
  --url https://api.adspirer.ai/api/v1/tools/get_linkedin_organizations/execute \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "arguments": {
    "account_id": "string"
  }
}
'

{
  "data": {
    "quota": {
      "limit": 150,
      "period_end": "2026-05-01",
      "tier": "plus",
      "used": 42
    },
    "text": "(tool-specific textual output for get_linkedin_organizations)"
  },
  "success": true,
  "tool": "get_linkedin_organizations"
}

Authorizations

Authorization

string

header

required

API key from https://adspirer.ai/keys. Prefix sk_live_. Treat as a secret — never commit.

Headers

Idempotency-Key

string<uuid>

Client-generated UUID to make writes idempotent. Strongly recommended for write tools. A repeat call with the same key returns the cached result instead of re-executing. Example: 550e8400-e29b-41d4-a716-446655440000

Body

application/json

All tool arguments are wrapped in an arguments object. The fields accepted inside arguments are listed below — required fields are marked with a red asterisk.

arguments

object

required

Input schema for getting LinkedIn Organizations (Company Pages)

Show child attributes

Response

Tool executed successfully. data.text carries the human-readable result (markdown-friendly). data.quota shows your current usage against the plan limit. data.structured appears when the tool emits machine-parseable structured content. data.content appears for tools that return non-text blocks (images, resources).

Returned on HTTP 200. data.text is the primary human-readable output. data.quota is always present for billable calls. data.structured is set only when the tool emits machine-parseable structured content. data.content is set only when the tool emits non-text content blocks.

data

object

required

Show child attributes

success

boolean

required

tool

string

required

Echoed tool_name from the request URL.

Last modified on April 23, 2026

List LinkedIn Campaign GroupsUser wants to see their LinkedIn campaign groups (also called campaign folders or groups). List all campaign groups with their status, budget, and campaign count. Parameters: - account_id: Optional LinkedIn Ad Account ID - status_filter: Filter by status (ACTIVE, PAUSED, ARCHIVED, or ALL) Returns: - All campaign groups with name, ID, status, budget, and campaign count Example Prompts: - "Show me my LinkedIn campaign groups" - "List all campaign groups" - "What campaign groups do I have?" - "Show active campaign groups" Execution time: 2-3 seconds

Get LinkedIn Organizations

curl --request POST \
  --url https://api.adspirer.ai/api/v1/tools/get_linkedin_organizations/execute \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "arguments": {
    "account_id": "string"
  }
}
'

{
  "data": {
    "quota": {
      "limit": 150,
      "period_end": "2026-05-01",
      "tier": "plus",
      "used": 42
    },
    "text": "(tool-specific textual output for get_linkedin_organizations)"
  },
  "success": true,
  "tool": "get_linkedin_organizations"
}