Tools for reading, starting, and pausing Facebook advertising campaigns, plus managing budgets and campaign names.
get_campaign
Retrieve full configuration details for a single Facebook campaign by its ID, including objective, status, spending cap, and bid strategy.
Parameters
| Parameter | Type | Description |
|---|---|---|
account_id |
string |
Facebook Ad Account ID (e.g., act_123456789) |
campaign_id |
string |
Facebook Campaign ID to retrieve |
Example
Natural Language
Show me the details of campaign 120211556789
Direct Query
{
"tool": "get_campaign",
"arguments": {
"account_id": "act_123456789",
"campaign_id": "120211556789"
}
}
get_campaigns
Retrieve configuration details for up to 50 Facebook campaigns in a single request. More efficient than calling get_campaign for each individually.
Parameters
| Parameter | Type | Description |
|---|---|---|
account_id |
string |
Facebook Ad Account ID (e.g., act_123456789) |
campaign_ids |
number[] |
List of campaign IDs to retrieve (max 50) |
next_page_url |
string | undefined |
Pagination URL from a previous response |
list_campaigns
List all Facebook campaigns in an ad account with optional filtering by status, objective, or date range.
Parameters
| Parameter | Type | Description |
|---|---|---|
account_id |
string |
Facebook Ad Account ID (e.g., act_123456789) |
Example
Natural Language
Show me all my active campaigns
List campaigns in account act_123456789
Direct Query
{
"tool": "list_campaigns",
"arguments": {
"account_id": "act_123456789"
}
}
pause_campaign
Pause a currently active Facebook campaign, stopping delivery of all its ad sets and ads simultaneously. Can be reactivated without recreating the campaign structure.
Parameters
| Parameter | Type | Description |
|---|---|---|
account_id |
string |
Facebook Ad Account ID (e.g., act_123456789) |
object_id |
string |
Campaign ID to pause |
Active Campaigns Only
Only campaigns with ACTIVE status can be paused.
Example
Natural Language
Pause campaign 120211556789
Direct Query
{
"tool": "pause_campaign",
"arguments": {
"account_id": "act_123456789",
"object_id": "120211556789"
}
}
start_campaign
Activate a paused Facebook campaign by setting its delivery status to ACTIVE. Use this to resume delivery without changing the campaign's configuration.
Parameters
| Parameter | Type | Description |
|---|---|---|
account_id |
string |
Facebook Ad Account ID (e.g., act_123456789) |
entity_id |
string |
Campaign ID to activate |
Paused Campaigns Only
Only campaigns with PAUSED status can be started. May fail if the campaign has billing or policy issues.
Example
Start campaign 120211556789
set_campaign_budget
Set the budget for a Facebook campaign to a specific amount. Used for Campaign Budget Optimization (CBO) campaigns.
Parameters
| Parameter | Type | Description |
|---|---|---|
account_id |
string |
Facebook Ad Account ID (e.g., act_123456789) |
entity_id |
string |
Campaign ID to update |
amount |
number |
New budget amount in account currency (cents) |
Example
Set campaign 120211556789 budget to $100/day
increase_campaign_budget
Increase the budget of a Facebook campaign by a specified amount or percentage.
Parameters
| Parameter | Type | Description |
|---|---|---|
account_id |
string |
Facebook Ad Account ID (e.g., act_123456789) |
entity_id |
string |
Campaign ID to update |
amount |
number |
Amount to increase the budget by |
Example
Increase campaign 120211556789 budget by $20
decrease_campaign_budget
Decrease the budget of a Facebook campaign by a specified amount or percentage.
Parameters
| Parameter | Type | Description |
|---|---|---|
account_id |
string |
Facebook Ad Account ID (e.g., act_123456789) |
entity_id |
string |
Campaign ID to update |
amount |
number |
Amount to decrease the budget by |
Example
Decrease campaign 120211556789 budget by $10
add_text_to_campaign_name
Add text to a Facebook campaign name by prepending or appending.
Parameters
| Parameter | Type | Description |
|---|---|---|
account_id |
string |
Facebook Ad Account ID (e.g., act_123456789) |
entity_id |
string |
Campaign 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: " ") |
Example
Add "[Q1]" prefix to campaign 120211556789 name
remove_text_from_campaign_name
Remove specific text from a Facebook campaign name.
Parameters
| Parameter | Type | Description |
|---|---|---|
account_id |
string |
Facebook Ad Account ID (e.g., act_123456789) |
entity_id |
string |
Campaign 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) |
Example
Remove "[OLD]" from campaign 120211556789 name
replace_text_in_campaign_name
Replace one substring with another in a Facebook campaign name.
Parameters
| Parameter | Type | Description |
|---|---|---|
account_id |
string |
Facebook Ad Account ID (e.g., act_123456789) |
entity_id |
string |
Campaign 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 "Summer" with "Winter" in campaign 120211556789 name
Related
- Ad Set Tools Manage ad sets within campaigns
- Campaign Insights View campaign performance metrics