list_ad_accounts
List every connected ad account in your organization, across every connected ad platform, with sync and connection status. Every other tool in this server takes an ad_account_id — use the returned id.
This is the same tool exposed by adlyse-insights, so a client connected to adlyse-ads alone can discover accounts without another server.
Parameters#
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
platform | string? | no | null | Only this platform’s accounts: google_ads, meta_ads, microsoft_ads, chatgpt_ads, applovin_ads, universal_ads or tiktok_ads. Omit to list all. |
Returns#
json
{
"ad_accounts": [
{
"id": "ad_acct_abc123",
"platform": "google_ads",
"external_account_id": "1234567890",
"account_name": "Acme Corp",
"currency_code": "USD",
"timezone": "America/New_York",
"is_active": true,
"connection_status": "connected_active",
"sync_status": "success",
"last_synced_at": "2026-04-22T14:03:11.942Z"
}
],
"count": 1,
"source": "adlyse.ad_accounts@v1"
}| Field | Type | Description |
|---|---|---|
ad_accounts[].id | string | Adlyse id; pass to other tools |
ad_accounts[].platform | string | "google_ads", "meta_ads", "microsoft_ads", or "chatgpt_ads" |
ad_accounts[].external_account_id | string | Platform’s own id (Google customer id, Meta act_…, etc.) |
ad_accounts[].account_name | string | Friendly name from the platform |
ad_accounts[].connection_status | string | connected_active, connected_inactive, or disconnected |
ad_accounts[].sync_status | string | pending, syncing, success, or error |
ad_accounts[].last_synced_at | string? | ISO-8601 of the most recent successful sync; null if never synced |
count | int | ad_accounts.length |
source | string | Provenance tag |
Errors#
error_type | When |
|---|---|
auth_error | Missing / invalid / revoked API key |
See also#
list_campaigns— drill into an account’s campaigns.get_performance— aggregate metrics for an account.adlyse-insights.get_dashboard_snapshot— Adlyse’s judgments for an account.