list_ad_accounts
List every connected ad account in your organization, across every connected ad platform, with sync and connection status. Use the returned id as the ad_account_id argument for the other tools in this server (and in adlyse-ads).
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 |
Example#
Request: no parameters (every platform).
Response:
json
{
"ad_accounts": [
{
"id": "ad_acct_wNkoZfSpRtL8oCNVAveYHe3o",
"platform": "google_ads",
"external_account_id": "1234567890",
"account_name": "Phunware",
"currency_code": "USD",
"timezone": "America/Los_Angeles",
"is_active": true,
"connection_status": "connected_active",
"sync_status": "success",
"last_synced_at": "2026-04-22T10:30:00Z"
}
],
"count": 1,
"source": "adlyse.ad_accounts@v1"
}See also#
get_dashboard_snapshot— pull the judgments for one of these accounts.adlyse-ads.list_campaigns— drill into an account’s campaigns.