meta_update_budget

Change the daily or lifetime budget of a Meta campaign or ad set, with a safety cap and a level check.

Ask to change the daily or the lifetime budget of a campaign or an ad set on Meta. AdCrunch checks the amount and the level of the budget before the change reaches Meta.

Raise the daily budget of Spring Prospecting to 150 euros.

The agent calls meta_update_budget, then get_mutation_status, and you see whether Meta applied the new budget. Change what runs on Meta lists each guardrail.

Reference

Available on:

Change a Meta campaign’s (Advantage campaign budget) or ad set’s daily or lifetime budget on a live ad account. Budgets are in whole units of the ad account currency: 10.5 is 10.50, never 1050. Provide exactly one of dailyBudget or lifetimeBudget. Runs asynchronously: returns a workflowId immediately — call get_mutation_status with it to see whether the change succeeded. Rejected if it exceeds the safety cap or targets the wrong level for the campaign’s budget setup.

Input

Argument	Type	Required	Description
`advertiserId`	string	yes	Advertiser account ID (`acc_<id>`). Must belong to the active organization.
`dailyBudget`	number, more than 0	no	New daily budget in whole units of the ad account currency (10.5 is 10.50). Provide this or `lifetimeBudget`, not both.
`id`	string	yes	The Meta object ID of the campaign or ad set.
`level`	one of `campaign`, `adset`	yes	Which level the `id` refers to.
`lifetimeBudget`	number, more than 0	no	New lifetime budget in whole units of the ad account currency (10.5 is 10.50). Provide this or `dailyBudget`, not both.

Output

A successful call returns this object in structuredContent.

Field	Type	Always present	Description
`workflowId`	string	yes	The id of the change. The change has not reached Meta yet. Give this id to `get_mutation_status` to find out how the change ended.

Failure codes

A failed call has isError set, and structuredContent.error holds one of these codes. Errors describes the shape of a failed call.

not_found
missing_write_access
forbidden
invalid_request
internal_error

Scope

The token must hold mutation:write. Auth & scopes lists each scope.

Annotations

A client reads these hints. A hint that the tool does not declare has the default value of the MCP specification.

Writes. The tool can change data.
Destructive. The tool can make a change that you cannot undo. A client can ask you to confirm before it calls the tool.
Not idempotent. A second call with the same arguments can change more.
Open world. The tool reaches a system outside AdCrunch, such as an ad platform.

Example

The arguments:

{
  "advertiserId": "acc_1485443900032333",
  "dailyBudget": 150,
  "id": "120215678901234567",
  "level": "campaign"
}

The result, in structuredContent:

{
  "workflowId": "3f9c2b7e-8a41-4d6e-9b05-c1e7a2d4f860"
}