---
title: list_advertisers
description: List the advertisers (ad accounts) in your organization, optionally filtered by provider.
---

import Callout from '#docs/components/mdx/callout.astro';

Lists every advertiser connected to your organization. Use this first to find the `advertiserId`s you'll pass to the other tools.

## Input

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `provider` | `'meta' \| 'tiktok' \| 'x' \| 'snapchat'` | no | Restrict to one provider. |
| `status` | `'ACTIVE' \| 'DISABLED'` | no | Filter by sync status. |

## Output

An array of advertisers. Each entry has `id` (`acc_*`), `provider`, `name`, and `status`.

## Example

> _"Show me my Meta advertisers."_

Claude calls `list_advertisers({ provider: 'meta' })` and reads back the list with their AdCrunch IDs.

> **Stable IDs**
>
> `acc_*` IDs are stable across syncs and across providers. The agent should
> refer to advertisers by `acc_*` ID, not by `name`, when chaining tools.

## Errors

- `401` or `403` — see [Errors](/mcp/errors), which every tool shares. This one needs `observe:read`.