Tools for reading, starting, and pausing Facebook ads, plus managing ad names. Ads inherit delivery settings from their parent ad set and contain the creative assets shown to users.
get_ad
Retrieve full configuration details for a single Facebook ad, including status, creative, and targeting inherited from its parent ad set.
Parameters
| Parameter | Type | Description |
|---|---|---|
account_id |
string |
Facebook Ad Account ID (e.g., act_123456789) |
ad_id |
string |
Facebook Ad ID to retrieve |
get_ads
Retrieve configuration details for up to 50 Facebook ads in a single request. More efficient than calling get_ad individually.
Parameters
| Parameter | Type | Description |
|---|---|---|
account_id |
string |
Facebook Ad Account ID (e.g., act_123456789) |
ad_ids |
number[] |
List of ad IDs to retrieve (max 50) |
list_ads_by_account
List all Facebook ads in an ad account with optional filtering by effective status, date range, and custom conditions.
Parameters
| Parameter | Type | Description |
|---|---|---|
account_id |
string |
Facebook Ad Account ID (e.g., act_123456789) |
list_ads_by_campaign
List all Facebook ads across all ad sets within a specific campaign. Useful for getting a complete view without querying each ad set separately.
Parameters
| Parameter | Type | Description |
|---|---|---|
account_id |
string |
Facebook Ad Account ID (e.g., act_123456789) |
campaign_id |
string |
Campaign ID to list ads for |
Example
Show me all ads in campaign 120211556789
list_ads_by_adset
List all Facebook ads within a specific ad set. Returns ad configuration data including creative, status, and bidding.
Parameters
| Parameter | Type | Description |
|---|---|---|
account_id |
string |
Facebook Ad Account ID (e.g., act_123456789) |
adset_id |
string |
Ad set ID to list ads for |
pause_ad
Pause a currently active Facebook ad to stop delivery immediately without deleting it. The ad can be reactivated later.
Parameters
| Parameter | Type | Description |
|---|---|---|
account_id |
string |
Facebook Ad Account ID (e.g., act_123456789) |
object_id |
string |
Ad ID to pause |
Active Ads Only
Only ads with ACTIVE status can be paused.
start_ad
Activate a paused Facebook ad by setting its delivery status to ACTIVE. The ad resumes serving without changing its creative, budget, or targeting.
Parameters
| Parameter | Type | Description |
|---|---|---|
account_id |
string |
Facebook Ad Account ID (e.g., act_123456789) |
entity_id |
string |
Ad ID to activate |
Paused Ads Only
Only ads with PAUSED status can be started. The parent campaign and ad set must also be active.
add_text_to_ad_name
Add text to a Facebook ad name by prepending or appending. Does not modify budget, status, targeting, or creatives.
Parameters
| Parameter | Type | Description |
|---|---|---|
account_id |
string |
Facebook Ad Account ID (e.g., act_123456789) |
entity_id |
string |
Ad ID to update |
text |
string |
Text to add (1-100 characters) |
position |
"prefix" | "suffix" |
Where to add text: "prefix" (beginning) or "suffix" (end). Default: "prefix" |
separator |
string | undefined |
Separator between added text and original name (max 5 characters, default: " ") |
remove_text_from_ad_name
Remove specific text from a Facebook ad name.
Parameters
| Parameter | Type | Description |
|---|---|---|
account_id |
string |
Facebook Ad Account ID (e.g., act_123456789) |
entity_id |
string |
Ad ID to update |
text |
string |
Text to remove (1-100 characters) |
position |
"prefix" | "suffix" | "anywhere" |
Where to remove text from. Default: "anywhere" |
case_sensitive |
boolean | undefined |
Whether removal is case-sensitive (default: false) |
replace_text_in_ad_name
Replace one substring with another in a Facebook ad name.
Parameters
| Parameter | Type | Description |
|---|---|---|
account_id |
string |
Facebook Ad Account ID (e.g., act_123456789) |
entity_id |
string |
Ad ID to update |
text_name_from |
string |
Text to find and replace (must be non-blank) |
text_name_to |
string |
Replacement text (must be non-blank) |
Example
Replace "v1" with "v2" in ad 120211556789 name
Related
- Ad Set Tools Manage parent ad sets
- Creative Tools Create and manage ad creatives
- Ad Insights View ad performance metrics