> ## Documentation Index
> Fetch the complete documentation index at: https://docs.automate.ax/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Automate.ax automations are TypeScript programs.
> Use Bun for installation and command examples.
> Use Automate.ax for the product name and automate.ax for the package, CLI, and domain.
> Treat documented public APIs as current; do not invent transitional or deprecated names.

# List ad groups

> List Google Ads ad groups with campaign, bids, type, and status.

Use `googleAds.listAdGroups` to list Google Ads ad groups with campaign, bids, type, and status.

## Example

```ts theme={null}
import { automation, onDashboardRun } from "automate.ax"
import { googleAds } from "automate.ax/google-ads"

export default automation("List ad groups", () => {
  onDashboardRun({ title: "List ad groups" })

  googleAds.listAdGroups({ customerId: "1234567890" })
})
```

## Inputs

Set `customerId`; optionally set `loginCustomerId` and `pageToken`. All customer-scoped actions accept optional `loginCustomerId` for manager-account access and a named Google account binding.

## Output

Returns `{ items, nextPageToken?, totalResultsCount? }`.