> ## 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 > Edit a catalog ad through update_meta_ad: name, status, an existing creative (creative_id), or new copy, CTA, landing page or product set, which become a new template creative on the ad (Meta creative > [!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 through update\_meta\_ad: name, status, an existing creative (creative\_id), or new copy, CTA, landing page or product set, which become a new template creative on the ad (Meta creatives cannot be edited in place; that needs page\_id, product\_set\_id and link). 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", "arguments": { ... }}`, or call `update_meta_catalog_ad` 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/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/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/execute: post: tags: - meta summary: >- Edit a catalog ad through update_meta_ad: name, status, an existing creative (creative_id), or new copy, CTA, landing page or product set, which become a new template creative on the ad (Meta creatives cannot be edited in place; that needs page_id, product_set_id and link). Staged for dashboard approval; nothing changes until it is approved. description: >- Edit a catalog ad through update_meta_ad: name, status, an existing creative (creative_id), or new copy, CTA, landing page or product set, which become a new template creative on the ad (Meta creatives cannot be edited in place; that needs page_id, product_set_id and link). 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 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_id: type: string description: Catalog ad to update. name: type: string description: New ad name. status: type: string enum: - ACTIVE - PAUSED - ARCHIVED - DELETED creative_id: type: string description: Swap in this existing creative. product_set_id: type: string description: Product set of the new creative. page_id: type: string description: Facebook Page the ad runs as. link: type: string description: >- Landing page (https); product links come from the catalog. message: type: string description: >- Primary text; may use catalog placeholders such as {{product.name}}. headline: type: string description: Headline (template), e.g. {{product.name}}. description: type: string description: Description (template), e.g. {{product.price}}. call_to_action: type: string description: Call-to-action type (default SHOP_NOW). 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_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.