list_ad_accounts
List every connected ad account in your organization, across every connected ad platform (Google Ads, Meta Ads, Microsoft Ads, ChatGPT Ads), with sync and connection status. Use the returned id in generate_report’s ad_account_ids and to filter list_report_targets.
This is the same tool exposed by adlyse-insights and adlyse-ads, so a client connected to adlyse-reports alone can discover accounts without another server.
Parameters#
None.
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#
generate_report— generate a report over one or more of these accounts.list_report_targets— KPI targets configured per account.