Get Connections Status

View connected ad accounts and OAuth connections.

Shows all connected ad platforms (Google Ads, TikTok Ads, Meta Ads, LinkedIn Ads) with:

Connection status and account details
Primary account indicator
Option to switch primary account
Quick links to connect new platforms

Use this tool when user asks about:

“how many accounts do I have” / “how many ad accounts”
“what accounts are connected” / “connected accounts”
“which account am I using” / “current account”
“show my connections” / “list my accounts”
“connection status” / “account status”
“what platforms do I have connected”
Account count, account list, or connection overview

Do not use for:

Discovering campaigns, ads, or keywords (use discover_existing_assets)
Performance data or metrics (use performance tools)
Creating or managing campaigns

This is specifically for OAuth connections and account management.

POST

/

api

/

v1

/

tools

/

get_connections_status

/

execute

Get Connections Status

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

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

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 get_connections_status tool - no required params

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 Connected AccountsList all connected ad accounts across platforms. Returns account IDs, names, and platforms for all active accounts. Use this at the start of every conversation to know which accounts are available. CRITICAL for multi-account users (agencies): - Always call this first to discover available accounts - Use the returned account IDs when calling any platform tool - If user mentions a business name, match it to an account from this list Returns for each account: - platform: google_ads, meta_ads, tiktok_ads, linkedin_ads - account_id: Platform account ID (pass to tools as customer_id/ad_account_id/advertiser_id/account_id) - account_name: Display name - account_tier: primary, secondary, or active - status: connected, needs_reauth Zero API calls — reads directly from database.

Get Connections Status

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

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