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. Every other tool in this server takes an ad_account_id — use the returned id.
This is the same tool exposed by adlyse-insights and adlyse-reports, so a client connected to adlyse-ads 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#
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.