meta_list_pixels
List the Meta Pixels installed on a Meta ad account.
An ad set that optimizes for conversions must name a Pixel. This lists the Pixels on the ad account so the agent can pick one instead of guessing.
Input
| Field | Type | Required | Description |
|---|---|---|---|
advertiserId |
acc_* |
yes | The Meta advertiser. Must belong to your active organization. |
Output
{ pixels: [{ id, name, lastFiredTime }] }. lastFiredTime is null for a Pixel that has never fired. An empty array means the account has no Pixel.
Example
“Which pixel should a conversion campaign on this account use?”
Claude calls meta_list_pixels({ advertiserId: 'acc_998877' }) and picks the one that fired most recently.
Prefer a pixel that has fired
Accounts routinely carry several Pixels of which only one is live. A Pixel
with no lastFiredTime is usually not installed on the site, and optimizing
toward it will not deliver.
Errors
Advertiser not found for this organization— theacc_*ID is unknown or belongs to another organization. Calllist_advertisersto find one you own.This advertiser has no usable Meta connection— reconnect Meta.- Anything Meta itself refuses is surfaced in Meta’s own words, including its error subcode.