> ## Documentation Index > Fetch the complete documentation index at: https://docs.adsmcp.si/llms.txt > Use this file to discover all available pages before exploring further. # update_meta_catalog_ad_set > Edit a catalog ad set through update_meta_ad_set: budget, bidding, targeting, placements, schedule, status, or swap the product set / conversion event (merged into the ad set's promoted_object) or the > [!WARNING] > > **Change — approval required.** Calling this tool does not change your ad account. ADSMCP checks the arguments and stages the change as a pending action. It runs only after a person approves it on the dashboard [Approvals](https://adsmcp.si/dashboard/approvals) page. Over MCP or REST you can view (`list_pending_actions`) or reject (`manage_action`) it, never approve it. `execution_mode` and similar arguments do not skip the queue. > > A change that fails when it runs is not retried automatically. It shows on the dashboard Execution Queue. Edit a catalog ad set through update\_meta\_ad\_set: budget, bidding, targeting, placements, schedule, status, or swap the product set / conversion event (merged into the ad set's promoted\_object) or the retargeting window (the product audience, which needs product\_set\_id). Targeting merges onto the live ad set at approval: each key you send replaces that key. Staged for dashboard approval; nothing changes until it is approved. **Platform:** Meta Ads · **Type:** Change ## How to call it * **MCP:** on `https://mcp.adsmcp.si/mcp`, run it through the `meta_ads_write` tool with `{"action": "execute", "tool_name": "update_meta_catalog_ad_set", "arguments": { ... }}`, or call `update_meta_catalog_ad_set` by name. `search_tools` finds it and `get_tool_schema` returns its arguments; `https://mcp.adsmcp.si/mcp/flat` lists every tool by name. * **REST:** `POST https://mcp.adsmcp.si/api/v1/tools/update_meta_catalog_ad_set/execute` with `Authorization: Bearer sk_live_...` and a JSON body `{"platform": "meta", "arguments": { ... }}`. The arguments are listed below; they are exactly the tool's input schema. ## OpenAPI ````yaml api-reference/openapi.json POST /api/v1/tools/update_meta_catalog_ad_set/execute openapi: 3.1.0 info: title: ADSMCP REST API version: 0.1.0 description: >- ADSMCP REST API: every public ADSMCP tool as POST /api/v1/tools/{name}/execute. Generated from the ADSMCP code (the service serves the same document at GET /api/v1/openapi.json). Changes to ad accounts are staged for approval by a person on the ADSMCP dashboard; nothing in this API can approve them. servers: - url: https://mcp.adsmcp.si description: ADSMCP MCP and REST service security: [] paths: /api/v1/tools/update_meta_catalog_ad_set/execute: post: tags: - meta summary: >- Edit a catalog ad set through update_meta_ad_set: budget, bidding, targeting, placements, schedule, status, or swap the product set / conversion event (merged into the ad set's promoted_object) or the retargeting window (the product audience, which needs product_set_id). Targeting merges onto the live ad set at approval: each key you send replaces that key. Staged for dashboard approval; nothing changes until it is approved. description: >- Edit a catalog ad set through update_meta_ad_set: budget, bidding, targeting, placements, schedule, status, or swap the product set / conversion event (merged into the ad set's promoted_object) or the retargeting window (the product audience, which needs product_set_id). Targeting merges onto the live ad set at approval: each key you send replaces that key. Staged for dashboard approval; nothing changes until it is approved. Use this when you intend that change. Write tools create paused objects or wait for approval, and a failed spend-affecting call is not retried automatically. operationId: execute_update_meta_catalog_ad_set parameters: - name: Authorization in: header required: true schema: type: string description: Bearer token - name: Idempotency-Key in: header required: false schema: type: string requestBody: required: false content: application/json: schema: type: object properties: platform: type: string default: meta arguments: type: object properties: account_id: type: string description: Meta ad account id (optional; never sent). ad_account_id: type: string description: Alias of account_id. ad_set_id: type: string description: Catalog ad set to update. name: type: string description: New name. status: type: string enum: - ACTIVE - PAUSED - ARCHIVED - DELETED daily_budget: type: integer minimum: 1 description: Daily budget (minor units). lifetime_budget: type: integer minimum: 1 description: Lifetime budget (minor units). daily_min_spend_target: type: integer minimum: 1 description: 'CBO only: minimum daily spend (minor units).' daily_spend_cap: type: integer minimum: 1 description: 'CBO only: maximum daily spend (minor units).' lifetime_min_spend_target: type: integer minimum: 1 description: 'CBO only: minimum lifetime spend (minor units).' lifetime_spend_cap: type: integer minimum: 1 description: 'CBO only: maximum lifetime spend (minor units).' bid_amount: type: integer minimum: 1 description: Bid cap or cost cap (minor units). bid_strategy: type: string description: Bid strategy. targeting: type: object additionalProperties: true description: Targeting keys to change (merged). start_time: type: string description: Start time (ISO 8601). end_time: type: string description: End time (ISO 8601). optimization_goal: type: string description: Optimization goal. product_set_id: type: string description: Swap in this product set. conversion_event: type: string enum: - PURCHASE - LEAD - COMPLETE_REGISTRATION - ADD_TO_CART - INITIATED_CHECKOUT - ADD_PAYMENT_INFO - CONTENT_VIEW - SEARCH - SUBSCRIBE - START_TRIAL - CONTACT - SUBMIT_APPLICATION - SCHEDULE - OTHER description: >- Conversion event the catalog ad set optimises for (default PURCHASE). retargeting_window_days: type: integer minimum: 1 maximum: 180 description: New retargeting window (needs product_set_id). confirm_delete: type: boolean description: Required (true) with status DELETED. execution_mode: type: string enum: - paused - approval_required description: Passed unchanged to every write call this tool makes. required: - ad_set_id additionalProperties: false additionalProperties: false responses: '200': description: Tool execution result. content: application/json: schema: $ref: '#/components/schemas/ExecuteToolResponse' '400': description: Invalid JSON input. '401': description: Authentication error. security: - bearerAuth: [] components: schemas: ExecuteToolResponse: type: object properties: ok: type: boolean platform: type: string tool: type: string data: {} error: anyOf: - type: 'null' - $ref: '#/components/schemas/ErrorResponse' mcp_response: {} required: - ok - platform - tool - error - mcp_response additionalProperties: false ErrorResponse: type: object properties: code: {} message: type: string details: {} required: - message additionalProperties: false securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: API token ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.