# Update entity (adsap_update_entity)

Edits an existing Meta campaign, ad set or ad.

Canonical: https://adsap.ai/docs/tools/adsap_update_entity
Updated: 2026-09-13

**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`](/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](/guides/campaigns/managing-campaigns) for the workflow around this tool, and the [Tool reference](/tools) for every tool.