Update entity (adsap_update_entity)
Platform: Meta · Read or write: Write · Plan: All plans · Consumes a task: Yes · Preview supported: Yes
What it does
Edits an existing Meta campaign, ad set or ad. You can change the name, the status, the budget, the schedule, or the targeting of an ad set. Only the fields you mention change. Ask for a preview to see the current value next to the new one before it applies.
Parameters
Descriptions are shortened from the tool schema. Your assistant sees the full text.
| Name | Type | Required | Description |
|---|---|---|---|
entity_type | one of campaign, adset, ad | Yes | |
entity_id | string | Yes | |
ad_account_id | string | Yes | |
updates | object | Yes | Only the fields you want to change. At least one is required. |
updates.name | string | No | |
updates.status | one of PAUSED, ACTIVE | No | |
updates.daily_budget | integer | No | In cents (minor units). campaign (CBO) or ad set (ABO) only: never on an ad. Mutually exclusive with lifetime_budget. |
updates.lifetime_budget | integer | No | In cents (minor units). campaign (CBO) or ad set (ABO) only. Mutually exclusive with daily_budget. |
updates.start_time | string | No | ISO 8601 start time. |
updates.end_time | string | No | ISO 8601 end time (ad set schedule). |
updates.stop_time | string | No | ISO 8601 stop time (campaign lifetime). |
updates.targeting | object | No | AD SET ONLY. Full Meta targeting spec, passed through to Meta as-is. Use adsap_search_interests / adsap_search_behaviors / adsap_search_geo_locations to obtain valid IDs first. |
dry_run | boolean | No | Preview only: the request is validated and the resolved payload returned, nothing is created or changed. |
Example prompts
- “Raise the daily budget on the Prospecting ad set to $80.”
- “Rename the campaign ‘Test 1’ to ‘Spring Launch, US’ and end it on May 31.”
- “Show me the diff if I widen the age range on the Retargeting ad set to 18 to 65.”
Notes
Budgets apply at the campaign level for CBO and at the ad set level for ABO. Targeting changes apply to ad sets only.
Related tools
adsap_set_entity_status: Pause or reactivate one or more Meta campaigns, ad sets, or ads in batch (max 50).
Guide
Read Managing campaigns for the workflow around this tool, and the Tool reference for every tool.
Last updated on