Change an Apple Ads campaign, ad group or keyword
Authorizations
Bearer authentication using the project Secret Key (prefixed with sk_), used exactly as shown in the dashboard. Endpoints that support sandbox data take an explicit environment field or parameter. All v4 public endpoints require the Secret Key — see Authentication. Never expose the Secret Key in client-side code.
Headers
Body
Exactly ONE of status, bid, daily_budget, and the matching before_* value, which is mandatory.
Required with bid: the current bid, as a decimal string or an {amount, currency} object. A new bid more than three times the last bid Qonversion saw Apple confirm is refused with 422. When there is no confirmed history the ceiling is not applied and the response says so with baseline_unverified.
Required — in the body, or via the Idempotency-Key header when the body has none (a key in the body wins); a request without it is refused with 422. Resending the same change with the same idempotency_key returns the original result with replayed: true. Reusing the key for a different change returns 409 idempotency_key_reuse. With the Idempotency-Key header, the API also caches successful (2xx) answers for 24 hours: a byte-identical resend gets the cached answer without replayed, and a different body with the same header key gets 409 idempotency_conflict. A dry run consumes its key: send the live change with a different key, otherwise you get the dry-run result back.
64Response
The change was accepted by Apple, or simulated when dry_run was set. A repeat of an earlier request with the same idempotency_key returns that request's stored result with replayed: true.
Present and true when there was no confirmed bid history for this entity, so the ×3 ceiling could NOT be applied and the change was counted as a raise. Treat it as a prompt for explicit human confirmation: it is the one signal that the server could not check the size of what it was about to do.