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 as the ad_account_id argument for the other tools in this server (and in adlyse-ads).
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 |
Example#
Request: no parameters.
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.