---
search:
  tags:
    - Campaigns
    - PATCH
seo:
  description: >-
    Available on: Meta. Reference for the PATCH
    /mutations/{advertiserId}/campaigns/{id}/bidding endpoint in the AdCrunch
    API.
sidebar:
  label: Update a campaign’s bidding
  badge: PATCH
title: Update a campaign’s bidding
type: openapi-operation
---
**Available on:** [![Meta](/providers/meta.svg)](https://docs.adcrunch.dev/connect/providers)

Changes the bidding of a campaign. The path names the campaign, and the body holds only the change.

It starts a Mutation of the kind `meta_update_bidding`, the same change that `POST /mutations` starts with that kind. The MCP tool of the same name makes the same change.

The change does **not** happen during this request. The answer is `202`, and `Location` names the Mutation. Poll `GET /mutations/{id}` until it reports `complete` or `errored`. A Mutation is durable, so the id stays valid across retries and restarts.

A refused request starts nothing. AdCrunch refuses a body that does not match, an advertiser that is not yours, an advertiser with no usable connection, and an advertiser connected without write access before a Mutation exists. So a failed call leaves no row in the history.

**This operation checks the credential first and the body second.** A missing or unusable credential answers `401` even when the body is wrong as well.

`PATCH /mutations/{advertiserId}/campaigns/{id}/bidding`

**Request body** (`application/json`, required)

- `bidCap` (number) — The highest bid Meta places in an auction. Only with LOWEST\_COST\_WITH\_BID\_CAP. A bid is per optimization event, for example per purchase, and per 1,000 impressions when the optimization goal is IMPRESSIONS or REACH. The amount is in whole units of the ad account currency: 2.5 is 2.50. Meta refuses more decimals than the currency has.
- `costCap` (number) — The average cost per result that Meta tries to keep. Only with COST\_CAP. A bid is per optimization event, for example per purchase, and per 1,000 impressions when the optimization goal is IMPRESSIONS or REACH. The amount is in whole units of the ad account currency: 2.5 is 2.50. Meta refuses more decimals than the currency has. A cost cap can stop the ad set before it spends its full budget.
- `roasFloor` (number) — The lowest return on ad spend that Meta bids for, as a ratio: 1.5 means purchase value of 1.5 times the spend. Only with LOWEST\_COST\_WITH\_MIN\_ROAS. From 0.01 to 1000, with at most 4 decimals.
- `bidStrategy` (string, required) — How Meta bids. LOWEST\_COST\_WITHOUT\_CAP ("Highest volume" in Ads Manager) gets the most results for the budget and takes no amount. LOWEST\_COST\_WITH\_BID\_CAP ("Bid cap") takes bidCap. COST\_CAP ("Cost per result goal") takes costCap. LOWEST\_COST\_WITH\_MIN\_ROAS ("ROAS goal") takes roasFloor, and needs the optimization goal VALUE. Give exactly the amount that the strategy takes, and no other amount. A higher bid cap, a higher cost cap or a lower ROAS floor can make an ad set spend its full budget, never more. Send the strategy also to change only an amount. A change of strategy starts the learning phase again, and a large change of amount can too. Meta refuses a change of strategy on a campaign with ad set budget sharing, on a campaign budget with more than 70 ad sets, and on a campaign budget on ROAS goal. Meta advises at most 2 or 3 bid or budget changes a day, and 15 minutes between a budget change and a bid change.

Request body example:

```json
{
  "bidStrategy": "LOWEST_COST_WITHOUT_CAP"
}
```

**Responses**

- `202` — The Mutation started, and it has not ended. The body is the answer of \`GET /mutations/{id}\`, with \`status\` of \`running\`. Poll the path in \`Location\` for the outcome.
- `400` — The request does not match the schema of this operation: a field is missing or has the wrong type, or the body is not valid JSON. \`error\` is \`invalid\_request\`, and \`issues\` names each field. Nothing was changed.
- `401` — No API key, or one that does not resolve. See the security scheme. \`error\` is \`unauthorized\`.
- `402` — The organization has no active subscription. An owner subscribes at \`paywallUrl\`. \`error\` is \`organization\_unentitled\`.
- `403` — The caller does not hold \`mutation:write\`, or the advertiser is connected without write access. In the second case \`error\` is \`missing\_write\_access\` and \`message\` says how to fix it. AdCrunch started nothing.
- `404` — The advertiser does not exist, it belongs to another organization, or it is not a Meta ad account. \`error\` is \`not\_found\` in each case. An advertiser that does not exist and an advertiser of another organization get the same answer on purpose, so a caller cannot learn which ids exist. AdCrunch started nothing.
- `409` — The advertiser has no usable connection: a person removed it, it expired, or the provider refused it. A person must connect it again. \`error\` is \`provider\_not\_connected\`, the code that a live read of Observe sends for the same failure. AdCrunch started nothing.

Response example, 202:

```json
{
  "mutationId": "mut_k3x9q2v7m4n8p1r5t6w0y2z4",
  "status": "running"
}
```
