AdsAgent — Meta Ads MCP

campaigns_quick_create

Prepare new ads or append to an existing campaign/ad set using request.ad_account_id, a saved template, and one creative_source. Choose append_mode and target IDs explicitly. Use copy_ad_quick_copy for live-ad copies. Review the draft; launch_confirm executes after approval Use the workflow's original link_id when exposed.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`request`	Yes
`connection_context`	No

Output Schema

TableJSON Schema

Name	Required	Description	Default
`message`	No
`retryable`	No
`support_ref`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed3 schema fields changedOct 17, 2026

changedInput schema / properties / request / properties / creative_source / oneOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "oneOf": [
-      {
-        "anyOf": [
-          {
-            "properties": {
-              "creative_names": {
-                "minItems": 1,
-                "type": "array"
-              }
-            },
-            "required": [
-              "creative_names"
-            ]
-          }
-        ],
-        "properties": {
-          "ad_name": {
-            "type": "null"
-          },
-          "carousel_groups": {
-            "maxItems": 0
-          },
-          "existing_posts": {
-            "maxItems": 0
-          },
-          "mode": {
-            "const": "creative"
-          },
-          "partnership_rows": {
-            "maxItems": 0
-          }
-        }
-      },
-      {
-        "properties": {
-          "ad_name": {
-            "type": "null"
-          },
-          "carousel_groups": {
-            "maxItems": 0
-          },
-          "creative_names": {
-            "maxItems": 0
-          },
-          "creative_overrides": {
-            "maxItems": 0
-          },
-          "existing_posts": {
-            "maxItems": 0
-          },
-          "mode": {
-            "const": "partnership"
-          },
-          "partnership_rows": {
-            "minItems": 1,
-            "type": "array"
-          }
-        },
-        "required": [
-          "mode",
-          "partnership_rows"
-        ]
-      },
-      {
-        "properties": {
-          "carousel_groups": {
-            "maxItems": 0
-          },
-          "creative_names": {
-            "maxItems": 0
-          },
-          "creative_overrides": {
-            "maxItems": 0
-          },
-          "existing_posts": {
-            "maxItems": 0
-          },
-          "media_mode": {
-            "const": "single"
-          },
-          "mode": {
-            "const": "template_source"
-          },
-          "partnership_rows": {
-            "maxItems": 0
-          }
-        },
-        "required": [
-          "mode"
-        ]
-      },
-      {
-        "properties": {
-          "ad_name": {
-            "type": "null"
-          },
-          "carousel_groups": {
-            "minItems": 1,
-            "type": "array"
-          },
-          "creative_names": {
-            "maxItems": 0
-          },
-          "creative_overrides": {
-            "maxItems": 0
-          },
-          "existing_posts": {
-            "maxItems": 0
-          },
-          "mode": {
-            "const": "carousel"
-          },
-          "partnership_rows": {
-            "maxItems": 0
-          }
-        },
-        "required": [
-          "mode",
-          "carousel_groups"
-        ]
-      },
-      {
-        "properties": {
-          "ad_name": {
-            "type": "null"
-          },
-          "carousel_groups": {
-            "maxItems": 0
-          },
-          "creative_names": {
-            "maxItems": 0
-          },
-          "creative_overrides": {
-            "maxItems": 0
-          },
-          "existing_posts": {
-            "minItems": 1,
-            "type": "array"
-          },
-          "media_mode": {
-            "const": "single"
-          },
-          "mode": {
-            "const": "existing_post"
-          },
-          "partnership_rows": {
-            "maxItems": 0
-          }
-        },
-        "required": [
-          "mode",
-          "existing_posts"
-        ]
-      }
-    ],
-    "properties": {
-      "ad_name": {
-        "maxLength": 500,
-        "minLength": 1,
-        "type": "string"
-      },
-      "carousel_groups": {
-        "items": {
-          "additionalProperties": false,
-          "allOf": [
-            {
-              "required": [
-                "ad_name"
-              ]
-            },
-            {
-              "properties": {
-                "creative_names": {
-                  "minItems": 2,
-                  "not": {
-                    "type": "null"
-                  }
-                }
-              },
-              "required": [
-                "creative_names"
-              ]
-            }
-          ],
-          "properties": {
-            "ad_name": {
-              "maxLength": 500,
-              "minLength": 1,
-              "type": "string"
-            },
-            "body": {
-              "maxLength": 5000,
-              "type": "string"
-            },
-            "creative_names": {
-              "items": {
-                "maxLength": 500,
-                "minLength": 1,
-                "type": "string"
-              },
-              "maxItems": 10,
-              "type": "array"
-            },
-            "description": {
-              "maxLength": 500,
-              "type": "string"
-            },
-            "title": {
-              "maxLength": 500,
-              "type": "string"
-            }
-          },
-          "type": "object"
-        },
-        "maxItems": 50,
-        "type": "array"
-      },
-      "creative_names": {
-        "items": {
-          "maxLength": 500,
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 50,
-        "type": "array"
-      },
-      "creative_overrides": {
-        "items": {
-          "additionalProperties": false,
-          "oneOf": [
-            {
-              "properties": {
-                "creative_name": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "creative_name"
-              ]
-            }
-          ],
-          "properties": {
-            "body": {
-              "maxLength": 5000,
-              "type": "string"
-            },
-            "creative_name": {
-              "maxLength": 500,
-              "minLength": 1,
-              "type": "string"
-            },
-            "deeplink": {
-              "maxLength": 2048,
-              "type": "string"
-            },
-            "description": {
-              "maxLength": 500,
-              "type": "string"
-            },
-            "title": {
-              "maxLength": 500,
-              "type": "string"
-            }
-          },
-          "type": "object"
-        },
-        "maxItems": 50,
-        "type": "array"
-      },
-      "existing_posts": {
-        "items": {
-          "additionalProperties": false,
-          "allOf": [
-            {
-              "required": [
-                "ad_name"
-              ]
-            },
-            {
-              "oneOf": [
-                {
-                  "properties": {
-                    "instagram_media_id": {
-                      "type": "string"
-                    },
-                    "page_post_id": {
-                      "type": "null"
-                    }
-                  },
-                  "required": [
-                    "instagram_media_id"
-                  ]
-                },
-                {
-                  "properties": {
-                    "instagram_media_id": {
-                      "type": "null"
-                    },
-                    "page_post_id": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "page_post_id"
-                  ]
-                }
-              ]
-            }
-          ],
-          "description": "One existing post that becomes one profile-visit ad.\n\nSupply the numeric Instagram media id (``GET /{ig-user-id}/media?fields=id,permalink``)\nor the Page post id ``<page_id>_<post_id>``; URLs and shortcodes are not accepted.",
-          "properties": {
-            "ad_name": {
-              "maxLength": 500,
-              "minLength": 1,
-              "type": "string"
-            },
-            "instagram_media_id": {
-              "pattern": "^[0-9]{1,32}$",
-              "type": "string"
-            },
-            "page_post_id": {
-              "pattern": "^[0-9]{1,32}_[0-9]{1,32}$",
-              "type": "string"
-            }
-          },
-          "required": [
-            "ad_name"
-          ],
-          "type": "object"
-        },
-        "maxItems": 50,
-        "type": "array"
-      },
-      "media_mode": {
-        "enum": [
-          "single",
-          "multi"
-        ],
-        "type": "string"
-      },
-      "mode": {
-        "default": "creative",
-        "enum": [
-          "creative",
-          "partnership",
-          "template_source",
-          "carousel",
-          "existing_post"
-        ],
-        "type": "string"
-      },
-      "partnership_rows": {
-        "items": {
-          "additionalProperties": false,
-          "anyOf": [
-            {
-              "required": [
-                "partnership_ad_id"
-              ]
-            }
-          ],
-          "properties": {
-            "ad_name": {
-              "maxLength": 500,
-              "minLength": 1,
-              "type": "string"
-            },
-            "deeplink": {
-              "maxLength": 2048,
-              "type": "string"
-            },
-            "original_post_url": {
-              "maxLength": 2048,
-              "type": "string"
-            },
-            "partnership_ad_id": {
-              "description": "Meta partnership ad ID.",
-              "maxLength": 4096,
-              "minLength": 1,
-              "type": "string"
-            },
-            "source_choice": {
-              "default": "auto",
-              "enum": [
-                "auto",
-                "new"
-              ],
-              "type": "string"
-            },
-            "source_ref": {
-              "pattern": "^(ad|creative):[0-9]{1,32}$",
-              "type": "string"
-            }
-          },
-          "required": [
-            "ad_name"
-          ],
-          "type": "object"
-        },
-        "maxItems": 50,
-        "type": "array"
-      }
-    },
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "media_mode": {
-        "const": "single",
-        "default": "single",
-        "type": "string"
-      },
-      "media_refs": {
-        "items": {
-          "maxLength": 2048,
-          "minLength": 16,
-          "pattern": "^media_e1\\.[A-Za-z0-9_-]+$",
-          "type": "string"
-        },
-        "maxItems": 50,
-        "minItems": 1,
-        "type": "array"
-      },
-      "mode": {
-        "const": "account_media",
-        "type": "string"
-      }
-    },
-    "required": [
-      "mode",
-      "media_refs"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "oneOf": [
+      {
+        "anyOf": [
+          {
+            "properties": {
+              "creative_names": {
+                "minItems": 1,
+                "type": "array"
+              }
+            },
+            "required": [
+              "creative_names"
+            ]
+          }
+        ],
+        "properties": {
+          "ad_name": {
+            "type": "null"
+          },
+          "carousel_groups": {
+            "maxItems": 0
+          },
+          "existing_posts": {
+            "maxItems": 0
+          },
+          "mode": {
+            "const": "creative"
+          },
+          "partnership_rows": {
+            "maxItems": 0
+          }
+        }
+      },
+      {
+        "properties": {
+          "ad_name": {
+            "type": "null"
+          },
+          "carousel_groups": {
+            "maxItems": 0
+          },
+          "creative_names": {
+            "maxItems": 0
+          },
+          "creative_overrides": {
+            "maxItems": 0
+          },
+          "existing_posts": {
+            "maxItems": 0
+          },
+          "mode": {
+            "const": "partnership"
+          },
+          "partnership_rows": {
+            "minItems": 1,
+            "type": "array"
+          }
+        },
+        "required": [
+          "mode",
+          "partnership_rows"
+        ]
+      },
+      {
+        "properties": {
+          "carousel_groups": {
+            "maxItems": 0
+          },
+          "creative_names": {
+            "maxItems": 0
+          },
+          "creative_overrides": {
+            "maxItems": 0
+          },
+          "existing_posts": {
+            "maxItems": 0
+          },
+          "media_mode": {
+            "const": "single"
+          },
+          "mode": {
+            "const": "template_source"
+          },
+          "partnership_rows": {
+            "maxItems": 0
+          }
+        },
+        "required": [
+          "mode"
+        ]
+      },
+      {
+        "properties": {
+          "ad_name": {
+            "type": "null"
+          },
+          "carousel_groups": {
+            "minItems": 1,
+            "type": "array"
+          },
+          "creative_names": {
+            "maxItems": 0
+          },
+          "creative_overrides": {
+            "maxItems": 0
+          },
+          "existing_posts": {
+            "maxItems": 0
+          },
+          "mode": {
+            "const": "carousel"
+          },
+          "partnership_rows": {
+            "maxItems": 0
+          }
+        },
+        "required": [
+          "mode",
+          "carousel_groups"
+        ]
+      },
+      {
+        "properties": {
+          "ad_name": {
+            "type": "null"
+          },
+          "carousel_groups": {
+            "maxItems": 0
+          },
+          "creative_names": {
+            "maxItems": 0
+          },
+          "creative_overrides": {
+            "maxItems": 0
+          },
+          "existing_posts": {
+            "minItems": 1,
+            "type": "array"
+          },
+          "media_mode": {
+            "const": "single"
+          },
+          "mode": {
+            "const": "existing_post"
+          },
+          "partnership_rows": {
+            "maxItems": 0
+          }
+        },
+        "required": [
+          "mode",
+          "existing_posts"
+        ]
+      }
+    ],
+    "properties": {
+      "ad_name": {
+        "maxLength": 500,
+        "minLength": 1,
+        "type": "string"
+      },
+      "carousel_groups": {
+        "items": {
+          "additionalProperties": false,
+          "allOf": [
+            {
+              "required": [
+                "ad_name"
+              ]
+            },
+            {
+              "properties": {
+                "creative_names": {
+                  "minItems": 2,
+                  "not": {
+                    "type": "null"
+                  }
+                }
+              },
+              "required": [
+                "creative_names"
+              ]
+            }
+          ],
+          "properties": {
+            "ad_name": {
+              "maxLength": 500,
+              "minLength": 1,
+              "type": "string"
+            },
+            "body": {
+              "maxLength": 5000,
+              "type": "string"
+            },
+            "card_overrides": {
+              "description": "Optional per-card title, description, link_url, cta and display_link, each matched to a card by creative_id/creative_name. A field left out falls back to this group's title/description and the template's link and CTA.",
+              "items": {
+                "additionalProperties": false,
+                "description": "Copy for one carousel card; every field left out uses the group's value.",
+                "oneOf": [
+                  {
+                    "properties": {
+                      "creative_name": {
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "creative_name"
+                    ]
+                  }
+                ],
+                "properties": {
+                  "creative_name": {
+                    "maxLength": 500,
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  "cta": {
+                    "description": "Call-to-action button. Common values: LEARN_MORE, SHOP_NOW, SIGN_UP, DOWNLOAD, INSTALL_MOBILE_APP, GET_OFFER, SUBSCRIBE, BOOK_NOW, APPLY_NOW, CONTACT_US, SEE_DETAILS. Free text is accepted and normalised (\"Learn More\" -> LEARN_MORE); Meta has more types than are listed here. Phone, message and profile CTAs do not fit a website or app destination. Omit to keep the template's CTA.",
+                    "maxLength": 100,
+                    "type": "string"
+                  },
+                  "description": {
+                    "maxLength": 500,
+                    "type": "string"
+                  },
+                  "display_link": {
+                    "description": "Display URL shown under the card (caption).",
+                    "maxLength": 255,
+                    "type": "string"
+                  },
+                  "link_url": {
+                    "description": "Card landing URL.",
+                    "maxLength": 2048,
+                    "type": "string"
+                  },
+                  "title": {
+                    "description": "Card headline.",
+                    "maxLength": 500,
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "maxItems": 10,
+              "type": "array"
+            },
+            "creative_names": {
+              "items": {
+                "maxLength": 500,
+                "minLength": 1,
+                "type": "string"
+              },
+              "maxItems": 10,
+              "type": "array"
+            },
+            "description": {
+              "maxLength": 500,
+              "type": "string"
+            },
+            "title": {
+              "maxLength": 500,
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "maxItems": 50,
+        "type": "array"
+      },
+      "creative_names": {
+        "items": {
+          "maxLength": 500,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 50,
+        "type": "array"
+      },
+      "creative_overrides": {
+        "items": {
+          "additionalProperties": false,
+          "oneOf": [
+            {
+              "properties": {
+                "creative_name": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "creative_name"
+              ]
+            }
+          ],
+          "properties": {
+            "body": {
+              "maxLength": 5000,
+              "type": "string"
+            },
+            "creative_name": {
+              "maxLength": 500,
+              "minLength": 1,
+              "type": "string"
+            },
+            "deeplink": {
+              "maxLength": 2048,
+              "type": "string"
+            },
+            "description": {
+              "maxLength": 500,
+              "type": "string"
+            },
+            "title": {
+              "maxLength": 500,
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "maxItems": 50,
+        "type": "array"
+      },
+      "existing_posts": {
+        "items": {
+          "additionalProperties": false,
+          "allOf": [
+            {
+              "required": [
+                "ad_name"
+              ]
+            },
+            {
+              "oneOf": [
+                {
+                  "properties": {
+                    "instagram_media_id": {
+                      "type": "string"
+                    },
+                    "page_post_id": {
+                      "type": "null"
+                    }
+                  },
+                  "required": [
+                    "instagram_media_id"
+                  ]
+                },
+                {
+                  "properties": {
+                    "instagram_media_id": {
+                      "type": "null"
+                    },
+                    "page_post_id": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "page_post_id"
+                  ]
+                }
+              ]
+            }
+          ],
+          "description": "One existing post that becomes one profile-visit ad.\n\nSupply the numeric Instagram media id (``GET /{ig-user-id}/media?fields=id,permalink``)\nor the Page post id ``<page_id>_<post_id>``; URLs and shortcodes are not accepted.",
+          "properties": {
+            "ad_name": {
+              "maxLength": 500,
+              "minLength": 1,
+              "type": "string"
+            },
+            "instagram_media_id": {
+              "pattern": "^[0-9]{1,32}$",
+              "type": "string"
+            },
+            "page_post_id": {
+              "pattern": "^[0-9]{1,32}_[0-9]{1,32}$",
+              "type": "string"
+            }
+          },
+          "required": [
+            "ad_name"
+          ],
+          "type": "object"
+        },
+        "maxItems": 50,
+        "type": "array"
+      },
+      "media_mode": {
+        "enum": [
+          "single",
+          "multi"
+        ],
+        "type": "string"
+      },
+      "mode": {
+        "default": "creative",
+        "enum": [
+          "creative",
+          "partnership",
+          "template_source",
+          "carousel",
+          "existing_post"
+        ],
+        "type": "string"
+      },
+      "partnership_rows": {
+        "items": {
+          "additionalProperties": false,
+          "anyOf": [
+            {
+              "required": [
+                "partnership_ad_id"
+              ]
+            }
+          ],
+          "properties": {
+            "ad_name": {
+              "maxLength": 500,
+              "minLength": 1,
+              "type": "string"
+            },
+            "deeplink": {
+              "maxLength": 2048,
+              "type": "string"
+            },
+            "original_post_url": {
+              "maxLength": 2048,
+              "type": "string"
+            },
+            "partnership_ad_id": {
+              "description": "Meta partnership ad ID.",
+              "maxLength": 4096,
+              "minLength": 1,
+              "type": "string"
+            },
+            "source_choice": {
+              "default": "auto",
+              "enum": [
+                "auto",
+                "new"
+              ],
+              "type": "string"
+            },
+            "source_ref": {
+              "pattern": "^(ad|creative):[0-9]{1,32}$",
+              "type": "string"
+            }
+          },
+          "required": [
+            "ad_name"
+          ],
+          "type": "object"
+        },
+        "maxItems": 50,
+        "type": "array"
+      }
+    },
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "media_mode": {
+        "const": "single",
+        "default": "single",
+        "type": "string"
+      },
+      "media_refs": {
+        "items": {
+          "maxLength": 2048,
+          "minLength": 16,
+          "pattern": "^media_e1\\.[A-Za-z0-9_-]+$",
+          "type": "string"
+        },
+        "maxItems": 50,
+        "minItems": 1,
+        "type": "array"
+      },
+      "mode": {
+        "const": "account_media",
+        "type": "string"
+      }
+    },
+    "required": [
+      "mode",
+      "media_refs"
+    ],
+    "type": "object"
+  }
+]

addedInput schema / properties / request / properties / overrides / properties / cta / description

Added value: +"Call-to-action button. Common values: LEARN_MORE, SHOP_NOW, SIGN_UP, DOWNLOAD, INSTALL_MOBILE_APP, GET_OFFER, SUBSCRIBE, BOOK_NOW, APPLY_NOW, CONTACT_US, SEE_DETAILS. Free text is accepted and normalised (\"Learn More\" -> LEARN_MORE); Meta has more types than are listed here. Phone, message and profile CTAs do not fit a website or app destination. Omit to keep the template's CTA."

addedInput schema / properties / request / properties / overrides / properties / display_link

Added value: +{
+  "description": "Display URL shown under single-image and carousel ads (link_data.caption). Ignored for video ads, which have no such field.",
+  "maxLength": 255,
+  "type": "string"
+}

Changed1 schema field changedOct 16, 2026

changedInput schema / properties / request / properties / creative_source / oneOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "oneOf": [
-      {
-        "anyOf": [
-          {
-            "properties": {
-              "creative_names": {
-                "minItems": 1,
-                "type": "array"
-              }
-            },
-            "required": [
-              "creative_names"
-            ]
-          }
-        ],
-        "properties": {
-          "ad_name": {
-            "type": "null"
-          },
-          "carousel_groups": {
-            "maxItems": 0
-          },
-          "existing_posts": {
-            "maxItems": 0
-          },
-          "mode": {
-            "const": "creative"
-          }
-        }
-      },
-      {
-        "properties": {
-          "carousel_groups": {
-            "maxItems": 0
-          },
-          "creative_names": {
-            "maxItems": 0
-          },
-          "creative_overrides": {
-            "maxItems": 0
-          },
-          "existing_posts": {
-            "maxItems": 0
-          },
-          "media_mode": {
-            "const": "single"
-          },
-          "mode": {
-            "const": "template_source"
-          }
-        },
-        "required": [
-          "mode"
-        ]
-      },
-      {
-        "properties": {
-          "ad_name": {
-            "type": "null"
-          },
-          "carousel_groups": {
-            "minItems": 1,
-            "type": "array"
-          },
-          "creative_names": {
-            "maxItems": 0
-          },
-          "creative_overrides": {
-            "maxItems": 0
-          },
-          "existing_posts": {
-            "maxItems": 0
-          },
-          "mode": {
-            "const": "carousel"
-          }
-        },
-        "required": [
-          "mode",
-          "carousel_groups"
-        ]
-      },
-      {
-        "properties": {
-          "ad_name": {
-            "type": "null"
-          },
-          "carousel_groups": {
-            "maxItems": 0
-          },
-          "creative_names": {
-            "maxItems": 0
-          },
-          "creative_overrides": {
-            "maxItems": 0
-          },
-          "existing_posts": {
-            "minItems": 1,
-            "type": "array"
-          },
-          "media_mode": {
-            "const": "single"
-          },
-          "mode": {
-            "const": "existing_post"
-          }
-        },
-        "required": [
-          "mode",
-          "existing_posts"
-        ]
-      }
-    ],
-    "properties": {
-      "ad_name": {
-        "maxLength": 500,
-        "minLength": 1,
-        "type": "string"
-      },
-      "carousel_groups": {
-        "items": {
-          "additionalProperties": false,
-          "allOf": [
-            {
-              "required": [
-                "ad_name"
-              ]
-            },
-            {
-              "properties": {
-                "creative_names": {
-                  "minItems": 2,
-                  "not": {
-                    "type": "null"
-                  }
-                }
-              },
-              "required": [
-                "creative_names"
-              ]
-            }
-          ],
-          "properties": {
-            "ad_name": {
-              "maxLength": 500,
-              "minLength": 1,
-              "type": "string"
-            },
-            "body": {
-              "maxLength": 5000,
-              "type": "string"
-            },
-            "creative_names": {
-              "items": {
-                "maxLength": 500,
-                "minLength": 1,
-                "type": "string"
-              },
-              "maxItems": 10,
-              "type": "array"
-            },
-            "description": {
-              "maxLength": 500,
-              "type": "string"
-            },
-            "title": {
-              "maxLength": 500,
-              "type": "string"
-            }
-          },
-          "type": "object"
-        },
-        "maxItems": 50,
-        "type": "array"
-      },
-      "creative_names": {
-        "items": {
-          "maxLength": 500,
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 50,
-        "type": "array"
-      },
-      "creative_overrides": {
-        "items": {
-          "additionalProperties": false,
-          "oneOf": [
-            {
-              "properties": {
-                "creative_name": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "creative_name"
-              ]
-            }
-          ],
-          "properties": {
-            "body": {
-              "maxLength": 5000,
-              "type": "string"
-            },
-            "creative_name": {
-              "maxLength": 500,
-              "minLength": 1,
-              "type": "string"
-            },
-            "deeplink": {
-              "maxLength": 2048,
-              "type": "string"
-            },
-            "description": {
-              "maxLength": 500,
-              "type": "string"
-            },
-            "title": {
-              "maxLength": 500,
-              "type": "string"
-            }
-          },
-          "type": "object"
-        },
-        "maxItems": 50,
-        "type": "array"
-      },
-      "existing_posts": {
-        "items": {
-          "additionalProperties": false,
-          "allOf": [
-            {
-              "required": [
-                "ad_name"
-              ]
-            },
-            {
-              "oneOf": [
-                {
-                  "properties": {
-                    "instagram_media_id": {
-                      "type": "string"
-                    },
-                    "page_post_id": {
-                      "type": "null"
-                    }
-                  },
-                  "required": [
-                    "instagram_media_id"
-                  ]
-                },
-                {
-                  "properties": {
-                    "instagram_media_id": {
-                      "type": "null"
-                    },
-                    "page_post_id": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "page_post_id"
-                  ]
-                }
-              ]
-            }
-          ],
-          "description": "One existing post that becomes one profile-visit ad.\n\nSupply the numeric Instagram media id (``GET /{ig-user-id}/media?fields=id,permalink``)\nor the Page post id ``<page_id>_<post_id>``; URLs and shortcodes are not accepted.",
-          "properties": {
-            "ad_name": {
-              "maxLength": 500,
-              "minLength": 1,
-              "type": "string"
-            },
-            "instagram_media_id": {
-              "pattern": "^[0-9]{1,32}$",
-              "type": "string"
-            },
-            "page_post_id": {
-              "pattern": "^[0-9]{1,32}_[0-9]{1,32}$",
-              "type": "string"
-            }
-          },
-          "required": [
-            "ad_name"
-          ],
-          "type": "object"
-        },
-        "maxItems": 50,
-        "type": "array"
-      },
-      "media_mode": {
-        "enum": [
-          "single",
-          "multi"
-        ],
-        "type": "string"
-      },
-      "mode": {
-        "default": "creative",
-        "enum": [
-          "creative",
-          "template_source",
-          "carousel",
-          "existing_post"
-        ],
-        "type": "string"
-      }
-    },
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "media_mode": {
-        "const": "single",
-        "default": "single",
-        "type": "string"
-      },
-      "media_refs": {
-        "items": {
-          "maxLength": 2048,
-          "minLength": 16,
-          "pattern": "^media_e1\\.[A-Za-z0-9_-]+$",
-          "type": "string"
-        },
-        "maxItems": 50,
-        "minItems": 1,
-        "type": "array"
-      },
-      "mode": {
-        "const": "account_media",
-        "type": "string"
-      }
-    },
-    "required": [
-      "mode",
-      "media_refs"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "oneOf": [
+      {
+        "anyOf": [
+          {
+            "properties": {
+              "creative_names": {
+                "minItems": 1,
+                "type": "array"
+              }
+            },
+            "required": [
+              "creative_names"
+            ]
+          }
+        ],
+        "properties": {
+          "ad_name": {
+            "type": "null"
+          },
+          "carousel_groups": {
+            "maxItems": 0
+          },
+          "existing_posts": {
+            "maxItems": 0
+          },
+          "mode": {
+            "const": "creative"
+          },
+          "partnership_rows": {
+            "maxItems": 0
+          }
+        }
+      },
+      {
+        "properties": {
+          "ad_name": {
+            "type": "null"
+          },
+          "carousel_groups": {
+            "maxItems": 0
+          },
+          "creative_names": {
+            "maxItems": 0
+          },
+          "creative_overrides": {
+            "maxItems": 0
+          },
+          "existing_posts": {
+            "maxItems": 0
+          },
+          "mode": {
+            "const": "partnership"
+          },
+          "partnership_rows": {
+            "minItems": 1,
+            "type": "array"
+          }
+        },
+        "required": [
+          "mode",
+          "partnership_rows"
+        ]
+      },
+      {
+        "properties": {
+          "carousel_groups": {
+            "maxItems": 0
+          },
+          "creative_names": {
+            "maxItems": 0
+          },
+          "creative_overrides": {
+            "maxItems": 0
+          },
+          "existing_posts": {
+            "maxItems": 0
+          },
+          "media_mode": {
+            "const": "single"
+          },
+          "mode": {
+            "const": "template_source"
+          },
+          "partnership_rows": {
+            "maxItems": 0
+          }
+        },
+        "required": [
+          "mode"
+        ]
+      },
+      {
+        "properties": {
+          "ad_name": {
+            "type": "null"
+          },
+          "carousel_groups": {
+            "minItems": 1,
+            "type": "array"
+          },
+          "creative_names": {
+            "maxItems": 0
+          },
+          "creative_overrides": {
+            "maxItems": 0
+          },
+          "existing_posts": {
+            "maxItems": 0
+          },
+          "mode": {
+            "const": "carousel"
+          },
+          "partnership_rows": {
+            "maxItems": 0
+          }
+        },
+        "required": [
+          "mode",
+          "carousel_groups"
+        ]
+      },
+      {
+        "properties": {
+          "ad_name": {
+            "type": "null"
+          },
+          "carousel_groups": {
+            "maxItems": 0
+          },
+          "creative_names": {
+            "maxItems": 0
+          },
+          "creative_overrides": {
+            "maxItems": 0
+          },
+          "existing_posts": {
+            "minItems": 1,
+            "type": "array"
+          },
+          "media_mode": {
+            "const": "single"
+          },
+          "mode": {
+            "const": "existing_post"
+          },
+          "partnership_rows": {
+            "maxItems": 0
+          }
+        },
+        "required": [
+          "mode",
+          "existing_posts"
+        ]
+      }
+    ],
+    "properties": {
+      "ad_name": {
+        "maxLength": 500,
+        "minLength": 1,
+        "type": "string"
+      },
+      "carousel_groups": {
+        "items": {
+          "additionalProperties": false,
+          "allOf": [
+            {
+              "required": [
+                "ad_name"
+              ]
+            },
+            {
+              "properties": {
+                "creative_names": {
+                  "minItems": 2,
+                  "not": {
+                    "type": "null"
+                  }
+                }
+              },
+              "required": [
+                "creative_names"
+              ]
+            }
+          ],
+          "properties": {
+            "ad_name": {
+              "maxLength": 500,
+              "minLength": 1,
+              "type": "string"
+            },
+            "body": {
+              "maxLength": 5000,
+              "type": "string"
+            },
+            "creative_names": {
+              "items": {
+                "maxLength": 500,
+                "minLength": 1,
+                "type": "string"
+              },
+              "maxItems": 10,
+              "type": "array"
+            },
+            "description": {
+              "maxLength": 500,
+              "type": "string"
+            },
+            "title": {
+              "maxLength": 500,
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "maxItems": 50,
+        "type": "array"
+      },
+      "creative_names": {
+        "items": {
+          "maxLength": 500,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 50,
+        "type": "array"
+      },
+      "creative_overrides": {
+        "items": {
+          "additionalProperties": false,
+          "oneOf": [
+            {
+              "properties": {
+                "creative_name": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "creative_name"
+              ]
+            }
+          ],
+          "properties": {
+            "body": {
+              "maxLength": 5000,
+              "type": "string"
+            },
+            "creative_name": {
+              "maxLength": 500,
+              "minLength": 1,
+              "type": "string"
+            },
+            "deeplink": {
+              "maxLength": 2048,
+              "type": "string"
+            },
+            "description": {
+              "maxLength": 500,
+              "type": "string"
+            },
+            "title": {
+              "maxLength": 500,
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "maxItems": 50,
+        "type": "array"
+      },
+      "existing_posts": {
+        "items": {
+          "additionalProperties": false,
+          "allOf": [
+            {
+              "required": [
+                "ad_name"
+              ]
+            },
+            {
+              "oneOf": [
+                {
+                  "properties": {
+                    "instagram_media_id": {
+                      "type": "string"
+                    },
+                    "page_post_id": {
+                      "type": "null"
+                    }
+                  },
+                  "required": [
+                    "instagram_media_id"
+                  ]
+                },
+                {
+                  "properties": {
+                    "instagram_media_id": {
+                      "type": "null"
+                    },
+                    "page_post_id": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "page_post_id"
+                  ]
+                }
+              ]
+            }
+          ],
+          "description": "One existing post that becomes one profile-visit ad.\n\nSupply the numeric Instagram media id (``GET /{ig-user-id}/media?fields=id,permalink``)\nor the Page post id ``<page_id>_<post_id>``; URLs and shortcodes are not accepted.",
+          "properties": {
+            "ad_name": {
+              "maxLength": 500,
+              "minLength": 1,
+              "type": "string"
+            },
+            "instagram_media_id": {
+              "pattern": "^[0-9]{1,32}$",
+              "type": "string"
+            },
+            "page_post_id": {
+              "pattern": "^[0-9]{1,32}_[0-9]{1,32}$",
+              "type": "string"
+            }
+          },
+          "required": [
+            "ad_name"
+          ],
+          "type": "object"
+        },
+        "maxItems": 50,
+        "type": "array"
+      },
+      "media_mode": {
+        "enum": [
+          "single",
+          "multi"
+        ],
+        "type": "string"
+      },
+      "mode": {
+        "default": "creative",
+        "enum": [
+          "creative",
+          "partnership",
+          "template_source",
+          "carousel",
+          "existing_post"
+        ],
+        "type": "string"
+      },
+      "partnership_rows": {
+        "items": {
+          "additionalProperties": false,
+          "anyOf": [
+            {
+              "required": [
+                "partnership_ad_id"
+              ]
+            }
+          ],
+          "properties": {
+            "ad_name": {
+              "maxLength": 500,
+              "minLength": 1,
+              "type": "string"
+            },
+            "deeplink": {
+              "maxLength": 2048,
+              "type": "string"
+            },
+            "original_post_url": {
+              "maxLength": 2048,
+              "type": "string"
+            },
+            "partnership_ad_id": {
+              "description": "Meta partnership ad ID.",
+              "maxLength": 4096,
+              "minLength": 1,
+              "type": "string"
+            },
+            "source_choice": {
+              "default": "auto",
+              "enum": [
+                "auto",
+                "new"
+              ],
+              "type": "string"
+            },
+            "source_ref": {
+              "pattern": "^(ad|creative):[0-9]{1,32}$",
+              "type": "string"
+            }
+          },
+          "required": [
+            "ad_name"
+          ],
+          "type": "object"
+        },
+        "maxItems": 50,
+        "type": "array"
+      }
+    },
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "media_mode": {
+        "const": "single",
+        "default": "single",
+        "type": "string"
+      },
+      "media_refs": {
+        "items": {
+          "maxLength": 2048,
+          "minLength": 16,
+          "pattern": "^media_e1\\.[A-Za-z0-9_-]+$",
+          "type": "string"
+        },
+        "maxItems": 50,
+        "minItems": 1,
+        "type": "array"
+      },
+      "mode": {
+        "const": "account_media",
+        "type": "string"
+      }
+    },
+    "required": [
+      "mode",
+      "media_refs"
+    ],
+    "type": "object"
+  }
+]

Changed6 schema fields changedOct 15, 2026
- addedOutput schema / else / then / properties / category
```
Added value: +{
+  "type": "string"
+}
```
- addedOutput schema / else / then / properties / expected
```
Added value: +{
+  "type": "boolean"
+}
```
- addedOutput schema / else / then / properties / failure_kind
```
Added value: +{
+  "type": "string"
+}
```
- addedOutput schema / else / then / properties / responsibility_hint
```
Added value: +{
+  "type": "string"
+}
```
- addedOutput schema / else / then / properties / route
```
Added value: +{
+  "type": "string"
+}
```
- addedOutput schema / else / then / properties / user_visible
```
Added value: +{
+  "type": "boolean"
+}
```
Changed1 schema field changedOct 13, 2026
- addedInput schema / properties / connection_context
```
Added value: +{
+  "pattern": "^mctx_v1_[0-9a-f]{64}$",
+  "type": "string"
+}
```

Changed6 schema fields changedOct 12, 2026

changedInput schema / properties / request / allOf

Previous value: -[
-  {
-    "required": [
-      "template_name"
-    ]
-  },
-  {
-    "required": [
-      "creative_source"
-    ]
-  }
-]New value: +[
+  {
+    "required": [
+      "template_name"
+    ]
+  },
+  {
+    "properties": {
+      "creative_source": {
+        "type": "object"
+      }
+    },
+    "required": [
+      "creative_source"
+    ]
+  }
+]

removedInput schema / properties / request / properties / creative_source / additionalProperties
```
Removed value: -false
```

addedInput schema / properties / request / properties / creative_source / discriminator

Added value: +{
+  "mapping": {
+    "account_media": "#/$defs/AccountMediaSource",
+    "carousel": "#/$defs/MCPCreativeSourceInput",
+    "creative": "#/$defs/MCPCreativeSourceInput",
+    "existing_post": "#/$defs/MCPCreativeSourceInput",
+    "partnership": "#/$defs/MCPCreativeSourceInput",
+    "template_source": "#/$defs/MCPCreativeSourceInput"
+  },
+  "propertyName": "mode"
+}

changedInput schema / properties / request / properties / creative_source / oneOf

Previous value: -[
-  {
-    "properties": {
-      "ad_name": {
-        "type": "null"
-      },
-      "creative_names": {
-        "minItems": 1
-      },
-      "mode": {
-        "const": "creative"
-      }
-    },
-    "propertyNames": {
-      "pattern": "^(m|cr)"
-    },
-    "required": [
-      "creative_names"
-    ]
-  },
-  {
-    "properties": {
-      "media_mode": {
-        "const": "single"
-      },
-      "mode": {
-        "const": "template_source"
-      }
-    },
-    "propertyNames": {
-      "pattern": "^(m|a)"
-    },
-    "required": [
-      "mode"
-    ]
-  },
-  {
-    "properties": {
-      "ad_name": {
-        "type": "null"
-      },
-      "carousel_groups": {
-        "minItems": 1
-      },
-      "mode": {
-        "const": "carousel"
-      }
-    },
-    "propertyNames": {
-      "pattern": "^(m|ca)"
-    },
-    "required": [
-      "mode",
-      "carousel_groups"
-    ]
-  },
-  {
-    "properties": {
-      "ad_name": {
-        "type": "null"
-      },
-      "carousel_groups": {
-        "maxItems": 0
-      },
-      "creative_names": {
-        "maxItems": 0
-      },
-      "creative_overrides": {
-        "maxItems": 0
-      },
-      "existing_posts": {
-        "minItems": 1,
-        "type": "array"
-      },
-      "media_mode": {
-        "const": "single"
-      },
-      "mode": {
-        "const": "existing_post"
-      }
-    },
-    "required": [
-      "mode",
-      "existing_posts"
-    ]
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "oneOf": [
+      {
+        "anyOf": [
+          {
+            "properties": {
+              "creative_names": {
+                "minItems": 1,
+                "type": "array"
+              }
+            },
+            "required": [
+              "creative_names"
+            ]
+          }
+        ],
+        "properties": {
+          "ad_name": {
+            "type": "null"
+          },
+          "carousel_groups": {
+            "maxItems": 0
+          },
+          "existing_posts": {
+            "maxItems": 0
+          },
+          "mode": {
+            "const": "creative"
+          }
+        }
+      },
+      {
+        "properties": {
+          "carousel_groups": {
+            "maxItems": 0
+          },
+          "creative_names": {
+            "maxItems": 0
+          },
+          "creative_overrides": {
+            "maxItems": 0
+          },
+          "existing_posts": {
+            "maxItems": 0
+          },
+          "media_mode": {
+            "const": "single"
+          },
+          "mode": {
+            "const": "template_source"
+          }
+        },
+        "required": [
+          "mode"
+        ]
+      },
+      {
+        "properties": {
+          "ad_name": {
+            "type": "null"
+          },
+          "carousel_groups": {
+            "minItems": 1,
+            "type": "array"
+          },
+          "creative_names": {
+            "maxItems": 0
+          },
+          "creative_overrides": {
+            "maxItems": 0
+          },
+          "existing_posts": {
+            "maxItems": 0
+          },
+          "mode": {
+            "const": "carousel"
+          }
+        },
+        "required": [
+          "mode",
+          "carousel_groups"
+        ]
+      },
+      {
+        "properties": {
+          "ad_name": {
+            "type": "null"
+          },
+          "carousel_groups": {
+            "maxItems": 0
+          },
+          "creative_names": {
+            "maxItems": 0
+          },
+          "creative_overrides": {
+            "maxItems": 0
+          },
+          "existing_posts": {
+            "minItems": 1,
+            "type": "array"
+          },
+          "media_mode": {
+            "const": "single"
+          },
+          "mode": {
+            "const": "existing_post"
+          }
+        },
+        "required": [
+          "mode",
+          "existing_posts"
+        ]
+      }
+    ],
+    "properties": {
+      "ad_name": {
+        "maxLength": 500,
+        "minLength": 1,
+        "type": "string"
+      },
+      "carousel_groups": {
+        "items": {
+          "additionalProperties": false,
+          "allOf": [
+            {
+              "required": [
+                "ad_name"
+              ]
+            },
+            {
+              "properties": {
+                "creative_names": {
+                  "minItems": 2,
+                  "not": {
+                    "type": "null"
+                  }
+                }
+              },
+              "required": [
+                "creative_names"
+              ]
+            }
+          ],
+          "properties": {
+            "ad_name": {
+              "maxLength": 500,
+              "minLength": 1,
+              "type": "string"
+            },
+            "body": {
+              "maxLength": 5000,
+              "type": "string"
+            },
+            "creative_names": {
+              "items": {
+                "maxLength": 500,
+                "minLength": 1,
+                "type": "string"
+              },
+              "maxItems": 10,
+              "type": "array"
+            },
+            "description": {
+              "maxLength": 500,
+              "type": "string"
+            },
+            "title": {
+              "maxLength": 500,
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "maxItems": 50,
+        "type": "array"
+      },
+      "creative_names": {
+        "items": {
+          "maxLength": 500,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 50,
+        "type": "array"
+      },
+      "creative_overrides": {
+        "items": {
+          "additionalProperties": false,
+          "oneOf": [
+            {
+              "properties": {
+                "creative_name": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "creative_name"
+              ]
+            }
+          ],
+          "properties": {
+            "body": {
+              "maxLength": 5000,
+              "type": "string"
+            },
+            "creative_name": {
+              "maxLength": 500,
+              "minLength": 1,
+              "type": "string"
+            },
+            "deeplink": {
+              "maxLength": 2048,
+              "type": "string"
+            },
+            "description": {
+              "maxLength": 500,
+              "type": "string"
+            },
+            "title": {
+              "maxLength": 500,
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "maxItems": 50,
+        "type": "array"
+      },
+      "existing_posts": {
+        "items": {
+          "additionalProperties": false,
+          "allOf": [
+            {
+              "required": [
+                "ad_name"
+              ]
+            },
+            {
+              "oneOf": [
+                {
+                  "properties": {
+                    "instagram_media_id": {
+                      "type": "string"
+                    },
+                    "page_post_id": {
+                      "type": "null"
+                    }
+                  },
+                  "required": [
+                    "instagram_media_id"
+                  ]
+                },
+                {
+                  "properties": {
+                    "instagram_media_id": {
+                      "type": "null"
+                    },
+                    "page_post_id": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "page_post_id"
+                  ]
+                }
+              ]
+            }
+          ],
+          "description": "One existing post that becomes one profile-visit ad.\n\nSupply the numeric Instagram media id (``GET /{ig-user-id}/media?fields=id,permalink``)\nor the Page post id ``<page_id>_<post_id>``; URLs and shortcodes are not accepted.",
+          "properties": {
+            "ad_name": {
+              "maxLength": 500,
+              "minLength": 1,
+              "type": "string"
+            },
+            "instagram_media_id": {
+              "pattern": "^[0-9]{1,32}$",
+              "type": "string"
+            },
+            "page_post_id": {
+              "pattern": "^[0-9]{1,32}_[0-9]{1,32}$",
+              "type": "string"
+            }
+          },
+          "required": [
+            "ad_name"
+          ],
+          "type": "object"
+        },
+        "maxItems": 50,
+        "type": "array"
+      },
+      "media_mode": {
+        "enum": [
+          "single",
+          "multi"
+        ],
+        "type": "string"
+      },
+      "mode": {
+        "default": "creative",
+        "enum": [
+          "creative",
+          "template_source",
+          "carousel",
+          "existing_post"
+        ],
+        "type": "string"
+      }
+    },
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "media_mode": {
+        "const": "single",
+        "default": "single",
+        "type": "string"
+      },
+      "media_refs": {
+        "items": {
+          "maxLength": 2048,
+          "minLength": 16,
+          "pattern": "^media_e1\\.[A-Za-z0-9_-]+$",
+          "type": "string"
+        },
+        "maxItems": 50,
+        "minItems": 1,
+        "type": "array"
+      },
+      "mode": {
+        "const": "account_media",
+        "type": "string"
+      }
+    },
+    "required": [
+      "mode",
+      "media_refs"
+    ],
+    "type": "object"
+  }
+]

removedInput schema / properties / request / properties / creative_source / properties

Removed value: -{
-  "ad_name": {
-    "maxLength": 500,
-    "minLength": 1,
-    "type": "string"
-  },
-  "carousel_groups": {
-    "items": {
-      "additionalProperties": false,
-      "allOf": [
-        {
-          "required": [
-            "ad_name"
-          ]
-        },
-        {
-          "properties": {
-            "creative_names": {
-              "minItems": 2,
-              "not": {
-                "type": "null"
-              }
-            }
-          },
-          "required": [
-            "creative_names"
-          ]
-        }
-      ],
-      "properties": {
-        "ad_name": {
-          "maxLength": 500,
-          "minLength": 1,
-          "type": "string"
-        },
-        "body": {
-          "maxLength": 5000,
-          "type": "string"
-        },
-        "creative_names": {
-          "items": {
-            "maxLength": 500,
-            "minLength": 1,
-            "type": "string"
-          },
-          "maxItems": 10,
-          "type": "array"
-        },
-        "description": {
-          "maxLength": 500,
-          "type": "string"
-        },
-        "title": {
-          "maxLength": 500,
-          "type": "string"
-        }
-      },
-      "type": "object"
-    },
-    "maxItems": 50,
-    "type": "array"
-  },
-  "creative_names": {
-    "items": {
-      "maxLength": 500,
-      "minLength": 1,
-      "type": "string"
-    },
-    "maxItems": 50,
-    "type": "array"
-  },
-  "creative_overrides": {
-    "items": {
-      "additionalProperties": false,
-      "oneOf": [
-        {
-          "properties": {
-            "creative_name": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "creative_name"
-          ]
-        }
-      ],
-      "properties": {
-        "body": {
-          "maxLength": 5000,
-          "type": "string"
-        },
-        "creative_name": {
-          "maxLength": 500,
-          "minLength": 1,
-          "type": "string"
-        },
-        "deeplink": {
-          "maxLength": 2048,
-          "type": "string"
-        },
-        "description": {
-          "maxLength": 500,
-          "type": "string"
-        },
-        "title": {
-          "maxLength": 500,
-          "type": "string"
-        }
-      },
-      "type": "object"
-    },
-    "maxItems": 50,
-    "type": "array"
-  },
-  "existing_posts": {
-    "items": {
-      "additionalProperties": false,
-      "allOf": [
-        {
-          "required": [
-            "ad_name"
-          ]
-        },
-        {
-          "oneOf": [
-            {
-              "properties": {
-                "instagram_media_id": {
-                  "type": "string"
-                },
-                "page_post_id": {
-                  "type": "null"
-                }
-              },
-              "required": [
-                "instagram_media_id"
-              ]
-            },
-            {
-              "properties": {
-                "instagram_media_id": {
-                  "type": "null"
-                },
-                "page_post_id": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "page_post_id"
-              ]
-            }
-          ]
-        }
-      ],
-      "description": "One existing post that becomes one profile-visit ad.\n\nSupply the numeric Instagram media id (``GET /{ig-user-id}/media?fields=id,permalink``)\nor the Page post id ``<page_id>_<post_id>``; URLs and shortcodes are not accepted.",
-      "properties": {
-        "ad_name": {
-          "maxLength": 500,
-          "minLength": 1,
-          "type": "string"
-        },
-        "instagram_media_id": {
-          "pattern": "^[0-9]{1,32}$",
-          "type": "string"
-        },
-        "page_post_id": {
-          "pattern": "^[0-9]{1,32}_[0-9]{1,32}$",
-          "type": "string"
-        }
-      },
-      "required": [
-        "ad_name"
-      ],
-      "type": "object"
-    },
-    "maxItems": 50,
-    "type": "array"
-  },
-  "media_mode": {
-    "enum": [
-      "single",
-      "multi"
-    ],
-    "type": "string"
-  },
-  "mode": {
-    "default": "creative",
-    "enum": [
-      "creative",
-      "template_source",
-      "carousel",
-      "existing_post"
-    ],
-    "type": "string"
-  }
-}

removedInput schema / properties / request / properties / creative_source / type
```
Removed value: -"object"
```

Changed4 schema fields changedOct 9, 2026

changedInput schema / properties / request / properties / creative_source / oneOf

Previous value: -[
-  {
-    "properties": {
-      "ad_name": {
-        "type": "null"
-      },
-      "creative_names": {
-        "minItems": 1
-      },
-      "mode": {
-        "const": "creative"
-      }
-    },
-    "propertyNames": {
-      "pattern": "^(m|cr)"
-    },
-    "required": [
-      "creative_names"
-    ]
-  },
-  {
-    "properties": {
-      "media_mode": {
-        "const": "single"
-      },
-      "mode": {
-        "const": "template_source"
-      }
-    },
-    "propertyNames": {
-      "pattern": "^(m|a)"
-    },
-    "required": [
-      "mode"
-    ]
-  },
-  {
-    "properties": {
-      "ad_name": {
-        "type": "null"
-      },
-      "carousel_groups": {
-        "minItems": 1
-      },
-      "mode": {
-        "const": "carousel"
-      }
-    },
-    "propertyNames": {
-      "pattern": "^(m|ca)"
-    },
-    "required": [
-      "mode",
-      "carousel_groups"
-    ]
-  }
-]New value: +[
+  {
+    "properties": {
+      "ad_name": {
+        "type": "null"
+      },
+      "creative_names": {
+        "minItems": 1
+      },
+      "mode": {
+        "const": "creative"
+      }
+    },
+    "propertyNames": {
+      "pattern": "^(m|cr)"
+    },
+    "required": [
+      "creative_names"
+    ]
+  },
+  {
+    "properties": {
+      "media_mode": {
+        "const": "single"
+      },
+      "mode": {
+        "const": "template_source"
+      }
+    },
+    "propertyNames": {
+      "pattern": "^(m|a)"
+    },
+    "required": [
+      "mode"
+    ]
+  },
+  {
+    "properties": {
+      "ad_name": {
+        "type": "null"
+      },
+      "carousel_groups": {
+        "minItems": 1
+      },
+      "mode": {
+        "const": "carousel"
+      }
+    },
+    "propertyNames": {
+      "pattern": "^(m|ca)"
+    },
+    "required": [
+      "mode",
+      "carousel_groups"
+    ]
+  },
+  {
+    "properties": {
+      "ad_name": {
+        "type": "null"
+      },
+      "carousel_groups": {
+        "maxItems": 0
+      },
+      "creative_names": {
+        "maxItems": 0
+      },
+      "creative_overrides": {
+        "maxItems": 0
+      },
+      "existing_posts": {
+        "minItems": 1,
+        "type": "array"
+      },
+      "media_mode": {
+        "const": "single"
+      },
+      "mode": {
+        "const": "existing_post"
+      }
+    },
+    "required": [
+      "mode",
+      "existing_posts"
+    ]
+  }
+]

addedInput schema / properties / request / properties / creative_source / properties / existing_posts

Added value: +{
+  "items": {
+    "additionalProperties": false,
+    "allOf": [
+      {
+        "required": [
+          "ad_name"
+        ]
+      },
+      {
+        "oneOf": [
+          {
+            "properties": {
+              "instagram_media_id": {
+                "type": "string"
+              },
+              "page_post_id": {
+                "type": "null"
+              }
+            },
+            "required": [
+              "instagram_media_id"
+            ]
+          },
+          {
+            "properties": {
+              "instagram_media_id": {
+                "type": "null"
+              },
+              "page_post_id": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "page_post_id"
+            ]
+          }
+        ]
+      }
+    ],
+    "description": "One existing post that becomes one profile-visit ad.\n\nSupply the numeric Instagram media id (``GET /{ig-user-id}/media?fields=id,permalink``)\nor the Page post id ``<page_id>_<post_id>``; URLs and shortcodes are not accepted.",
+    "properties": {
+      "ad_name": {
+        "maxLength": 500,
+        "minLength": 1,
+        "type": "string"
+      },
+      "instagram_media_id": {
+        "pattern": "^[0-9]{1,32}$",
+        "type": "string"
+      },
+      "page_post_id": {
+        "pattern": "^[0-9]{1,32}_[0-9]{1,32}$",
+        "type": "string"
+      }
+    },
+    "required": [
+      "ad_name"
+    ],
+    "type": "object"
+  },
+  "maxItems": 50,
+  "type": "array"
+}

changedInput schema / properties / request / properties / creative_source / properties / mode / enum

Previous value: -[
-  "creative",
-  "template_source",
-  "carousel"
-]New value: +[
+  "creative",
+  "template_source",
+  "carousel",
+  "existing_post"
+]

changedOutput schema / else / else / anyOf

Previous value: -[
-  {
-    "properties": {
-      "approval_request": {
-        "properties": {
-          "approval_ref": {
-            "type": "string"
-          },
-          "confirm_token": {
-            "type": "string"
-          },
-          "expires_at": {
-            "type": "string"
-          },
-          "mode": {
-            "type": "string"
-          },
-          "plan_digest": {
-            "type": "string"
-          },
-          "schema_version": {
-            "type": "integer"
-          },
-          "status": {
-            "const": "approval_required"
-          },
-          "summary": {
-            "properties": {
-              "account_currency": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "action": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "ad_account_id": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "ad_count": {
-                "type": "integer"
-              },
-              "ad_id": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "ad_name_after": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "ad_name_before": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "ad_status": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "adset_count": {
-                "type": "integer"
-              },
-              "adset_id": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "adset_status": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "bid": {
-                "$ref": "#/$defs/s0"
-              },
-              "budget": {
-                "$ref": "#/$defs/s0"
-              },
-              "campaign_count": {
-                "type": "integer"
-              },
-              "campaign_id": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "campaign_status": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "change_percent": {
-                "type": [
-                  "number",
-                  "null"
-                ]
-              },
-              "copies": {
-                "type": "integer"
-              },
-              "count": {
-                "type": "integer"
-              },
-              "creative_after": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "creative_before": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "cross_account": {
-                "type": "boolean"
-              },
-              "current_daily_budget": {
-                "type": [
-                  "number",
-                  "null"
-                ]
-              },
-              "engagement_mode": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "entity_id": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "entity_type": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "groups": {
-                "items": {
-                  "properties": {
-                    "adsets": {
-                      "items": {
-                        "properties": {
-                          "name": {
-                            "type": [
-                              "string",
-                              "null"
-                            ]
-                          },
-                          "target_adset_id": {
-                            "type": [
-                              "string",
-                              "null"
-                            ]
-                          }
-                        },
-                        "type": "object"
-                      },
-                      "type": "array"
-                    },
-                    "bid": {
-                      "$ref": "#/$defs/s1"
-                    },
-                    "budget": {
-                      "$ref": "#/$defs/s1"
-                    },
-                    "campaign_name": {
-                      "type": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "layout": {
-                      "type": "string"
-                    }
-                  },
-                  "type": "object"
-                },
-                "type": "array"
-              },
-              "items": {
-                "items": {
-                  "properties": {
-                    "ad_account_id": {
-                      "type": "string"
-                    },
-                    "ad_id": {
-                      "type": "string"
-                    },
-                    "campaign_id": {
-                      "type": "string"
-                    },
-                    "current_configured_status": {
-                      "type": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "current_daily_budget": {
-                      "type": [
-                        "number",
-                        "null"
-                      ]
-                    },
-                    "new_daily_budget": {
-                      "type": [
-                        "number",
-                        "null"
-                      ]
-                    },
-                    "target_configured_status": {
-                      "type": "string"
-                    }
-                  },
-                  "type": "object"
-                },
-                "type": "array"
-              },
-              "mode": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "new_daily_budget": {
-                "type": [
-                  "number",
-                  "null"
-                ]
-              },
-              "note": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "page_id_after": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "page_id_before": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "preflight": {
-                "properties": {
-                  "ad_account_id": {
-                    "type": "string"
-                  },
-                  "billing": {
-                    "properties": {
-                      "available_funds_major": {
-                        "type": [
-                          "number",
-                          "null"
-                        ]
-                      },
-                      "balance_semantics": {
-                        "type": "string"
-                      },
-                      "currency": {
-                        "type": [
-                          "string",
-                          "null"
-                        ]
-                      },
-                      "low_remaining_spend_cap": {
-                        "type": "boolean"
-                      },
-                      "note": {
-                        "type": "string"
-                      },
-                      "reported_balance_major": {
-                        "type": [
-                          "number",
-                          "null"
-                        ]
-                      },
-                      "spend_cap_remaining_major": {
-                        "type": [
-                          "number",
-                          "null"
-                        ]
-                      }
-                    },
-                    "type": "object"
-                  },
-                  "checked_at": {
-                    "type": "string"
-                  },
-                  "checks": {
-                    "items": {
-                      "properties": {
-                        "asset_id": {
-                          "type": "string"
-                        },
-                        "asset_type": {
-                          "type": "string"
-                        },
-                        "message": {
-                          "type": "string"
-                        },
-                        "status": {
-                          "type": "string"
-                        }
-                      },
-                      "type": "object"
-                    },
-                    "type": "array"
-                  },
-                  "status": {
-                    "type": "string"
-                  },
-                  "timing": {
-                    "properties": {
-                      "account_local_now": {
-                        "type": [
-                          "string",
-                          "null"
-                        ]
-                      },
-                      "hours_left_today": {
-                        "type": [
-                          "number",
-                          "null"
-                        ]
-                      },
-                      "note": {
-                        "type": "string"
-                      },
-                      "schedule_valid": {
-                        "type": "boolean"
-                      },
-                      "timezone_name": {
-                        "type": [
-                          "string",
-                          "null"
-                        ]
-                      },
-                      "utc_offset_hours": {
-                        "type": "number"
-                      },
-                      "windows": {
-                        "items": {
-                          "properties": {
-                            "end_time": {
-                              "type": [
-                                "string",
-                                "null"
-                              ]
-                            },
-                            "hours_remaining": {
-                              "type": [
-                                "number",
-                                "null"
-                              ]
-                            },
-                            "hours_until_start": {
-                              "type": "number"
-                            },
-                            "paused": {
-                              "type": "boolean"
-                            },
-                            "potential_delivery_hours_today": {
-                              "type": "number"
-                            },
-                            "start_time": {
-                              "type": [
-                                "string",
-                                "null"
-                              ]
-                            }
-                          },
-                          "type": "object"
-                        },
-                        "type": "array"
-                      }
-                    },
-                    "type": "object"
-                  },
-                  "version": {
-                    "type": "integer"
-                  },
-                  "warnings": {
-                    "items": {
-                      "type": "string"
-                    },
-                    "type": "array"
-                  }
-                },
-                "required": [
-                  "version",
-                  "checked_at",
-                  "ad_account_id",
-                  "status",
-                  "checks",
-                  "warnings"
-                ],
-                "type": "object"
-              },
-              "publish_start_label": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "source_ad_account_id": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "source_ad_id": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "source_id": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "source_level": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "source_name": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "statuses": {
-                "properties": {
-                  "ad": {
-                    "type": [
-                      "string",
-                      "null"
-                    ]
-                  },
-                  "adset": {
-                    "type": [
-                      "string",
-                      "null"
-                    ]
-                  },
-                  "campaign": {
-                    "type": [
-                      "string",
-                      "null"
-                    ]
-                  }
-                },
-                "type": "object"
-              },
-              "structure": {
-                "properties": {
-                  "ads": {
-                    "type": "integer"
-                  },
-                  "adsets": {
-                    "type": "integer"
-                  },
-                  "auxiliary_writes": {
-                    "type": "integer"
-                  },
-                  "campaigns": {
-                    "type": "integer"
-                  },
-                  "creative_keys": {
-                    "type": "integer"
-                  },
-                  "layouts": {
-                    "items": {
-                      "type": "string"
-                    },
-                    "type": "array"
-                  }
-                },
-                "type": "object"
-              },
-              "target_ad_account_id": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "template_name": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "warnings": {
-                "$ref": "#/$defs/s2"
-              }
-            },
-            "type": "object"
-          },
-          "tool_name": {
-            "type": "string"
-          },
-          "user_instruction": {
-            "type": "string"
-          },
-          "warnings": {
-            "$ref": "#/$defs/s2"
-          }
-        },
-        "required": [
-          "status",
-          "confirm_token",
-          "expires_at",
-          "summary"
-        ],
-        "type": "object"
-      },
-      "status": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "approval_request"
-    ]
-  },
-  {
-    "properties": {
-      "missing_requirements": {
-        "items": {
-          "properties": {
-            "field": {
-              "type": "string"
-            },
-            "message": {
-              "type": "string"
-            },
-            "override_path": {
-              "type": "string"
-            }
-          },
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "safe_to_retry_with_user_input": {
-        "const": true
-      },
-      "status": {
-        "const": "needs_input"
-      },
-      "user_instruction": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "status",
-      "user_instruction",
-      "safe_to_retry_with_user_input"
-    ]
-  },
-  {
-    "properties": {
-      "account_blocker_code": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "account_blocker_label": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "ad_account_id": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "ad_account_name": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "automatic_retry_allowed": {
-        "type": "boolean"
-      },
-      "category": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "code": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "invalid_fields": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "manual_new_task_allowed": {
-        "type": "boolean"
-      },
-      "narrative": {
-        "properties": {
-          "details": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "headline": {
-            "type": "string"
-          },
-          "summary": {
-            "type": "string"
-          },
-          "user_instruction": {
-            "type": "string"
-          },
-          "what_happens_next": {
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "operator_review_required": {
-        "type": "boolean"
-      },
-      "status": {
-        "const": "blocked"
-      },
-      "warnings": {
-        "$ref": "#/$defs/s2"
-      }
-    },
-    "required": [
-      "status",
-      "narrative"
-    ]
-  }
-]New value: +[
+  {
+    "properties": {
+      "approval_request": {
+        "properties": {
+          "approval_ref": {
+            "type": "string"
+          },
+          "confirm_token": {
+            "type": "string"
+          },
+          "expires_at": {
+            "type": "string"
+          },
+          "mode": {
+            "type": "string"
+          },
+          "plan_digest": {
+            "type": "string"
+          },
+          "schema_version": {
+            "type": "integer"
+          },
+          "status": {
+            "const": "approval_required"
+          },
+          "summary": {
+            "properties": {
+              "account_currency": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "action": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "ad_account_id": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "ad_count": {
+                "type": "integer"
+              },
+              "ad_id": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "ad_name_after": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "ad_name_before": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "ad_status": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "adset_count": {
+                "type": "integer"
+              },
+              "adset_id": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "adset_status": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "bid": {
+                "$ref": "#/$defs/s0"
+              },
+              "budget": {
+                "$ref": "#/$defs/s0"
+              },
+              "campaign_count": {
+                "type": "integer"
+              },
+              "campaign_id": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "campaign_status": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "change_percent": {
+                "type": [
+                  "number",
+                  "null"
+                ]
+              },
+              "copies": {
+                "type": "integer"
+              },
+              "count": {
+                "type": "integer"
+              },
+              "creative_after": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "creative_before": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "cross_account": {
+                "type": "boolean"
+              },
+              "current_daily_budget": {
+                "type": [
+                  "number",
+                  "null"
+                ]
+              },
+              "engagement_mode": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "entity_id": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "entity_type": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "groups": {
+                "items": {
+                  "properties": {
+                    "adsets": {
+                      "items": {
+                        "properties": {
+                          "name": {
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          },
+                          "target_adset_id": {
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          }
+                        },
+                        "type": "object"
+                      },
+                      "type": "array"
+                    },
+                    "bid": {
+                      "$ref": "#/$defs/s1"
+                    },
+                    "budget": {
+                      "$ref": "#/$defs/s1"
+                    },
+                    "campaign_name": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "layout": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "items": {
+                "items": {
+                  "properties": {
+                    "ad_account_id": {
+                      "type": "string"
+                    },
+                    "ad_id": {
+                      "type": "string"
+                    },
+                    "campaign_id": {
+                      "type": "string"
+                    },
+                    "current_configured_status": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "current_daily_budget": {
+                      "type": [
+                        "number",
+                        "null"
+                      ]
+                    },
+                    "new_daily_budget": {
+                      "type": [
+                        "number",
+                        "null"
+                      ]
+                    },
+                    "target_configured_status": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "mode": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "new_daily_budget": {
+                "type": [
+                  "number",
+                  "null"
+                ]
+              },
+              "note": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "page_id_after": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "page_id_before": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "preflight": {
+                "properties": {
+                  "ad_account_id": {
+                    "type": "string"
+                  },
+                  "billing": {
+                    "properties": {
+                      "available_funds_major": {
+                        "type": [
+                          "number",
+                          "null"
+                        ]
+                      },
+                      "balance_semantics": {
+                        "type": "string"
+                      },
+                      "currency": {
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "low_remaining_spend_cap": {
+                        "type": "boolean"
+                      },
+                      "note": {
+                        "type": "string"
+                      },
+                      "reported_balance_major": {
+                        "type": [
+                          "number",
+                          "null"
+                        ]
+                      },
+                      "spend_cap_remaining_major": {
+                        "type": [
+                          "number",
+                          "null"
+                        ]
+                      }
+                    },
+                    "type": "object"
+                  },
+                  "checked_at": {
+                    "type": "string"
+                  },
+                  "checks": {
+                    "items": {
+                      "properties": {
+                        "asset_id": {
+                          "type": "string"
+                        },
+                        "asset_type": {
+                          "type": "string"
+                        },
+                        "message": {
+                          "type": "string"
+                        },
+                        "provider_error_code": {
+                          "type": "integer"
+                        },
+                        "provider_error_subcode": {
+                          "type": "integer"
+                        },
+                        "reason_code": {
+                          "type": "string"
+                        },
+                        "status": {
+                          "type": "string"
+                        }
+                      },
+                      "type": "object"
+                    },
+                    "type": "array"
+                  },
+                  "status": {
+                    "type": "string"
+                  },
+                  "timing": {
+                    "properties": {
+                      "account_local_now": {
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "hours_left_today": {
+                        "type": [
+                          "number",
+                          "null"
+                        ]
+                      },
+                      "note": {
+                        "type": "string"
+                      },
+                      "schedule_valid": {
+                        "type": "boolean"
+                      },
+                      "timezone_name": {
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "utc_offset_hours": {
+                        "type": "number"
+                      },
+                      "windows": {
+                        "items": {
+                          "properties": {
+                            "end_time": {
+                              "type": [
+                                "string",
+                                "null"
+                              ]
+                            },
+                            "hours_remaining": {
+                              "type": [
+                                "number",
+                                "null"
+                              ]
+                            },
+                            "hours_until_start": {
+                              "type": "number"
+                            },
+                            "paused": {
+                              "type": "boolean"
+                            },
+                            "potential_delivery_hours_today": {
+                              "type": "number"
+                            },
+                            "start_time": {
+                              "type": [
+                                "string",
+                                "null"
+                              ]
+                            }
+                          },
+                          "type": "object"
+                        },
+                        "type": "array"
+                      }
+                    },
+                    "type": "object"
+                  },
+                  "version": {
+                    "type": "integer"
+                  },
+                  "warnings": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  }
+                },
+                "required": [
+                  "version",
+                  "checked_at",
+                  "ad_account_id",
+                  "status",
+                  "checks",
+                  "warnings"
+                ],
+                "type": "object"
+              },
+              "publish_start_label": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "source_ad_account_id": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "source_ad_id": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "source_id": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "source_level": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "source_name": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "statuses": {
+                "properties": {
+                  "ad": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "adset": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "campaign": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  }
+                },
+                "type": "object"
+              },
+              "structure": {
+                "properties": {
+                  "ads": {
+                    "type": "integer"
+                  },
+                  "adsets": {
+                    "type": "integer"
+                  },
+                  "auxiliary_writes": {
+                    "type": "integer"
+                  },
+                  "campaigns": {
+                    "type": "integer"
+                  },
+                  "creative_keys": {
+                    "type": "integer"
+                  },
+                  "layouts": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  }
+                },
+                "type": "object"
+              },
+              "target_ad_account_id": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "template_name": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "warnings": {
+                "$ref": "#/$defs/s2"
+              }
+            },
+            "type": "object"
+          },
+          "tool_name": {
+            "type": "string"
+          },
+          "user_instruction": {
+            "type": "string"
+          },
+          "warnings": {
+            "$ref": "#/$defs/s2"
+          }
+        },
+        "required": [
+          "status",
+          "confirm_token",
+          "expires_at",
+          "summary"
+        ],
+        "type": "object"
+      },
+      "status": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "approval_request"
+    ]
+  },
+  {
+    "properties": {
+      "missing_requirements": {
+        "items": {
+          "properties": {
+            "field": {
+              "type": "string"
+            },
+            "message": {
+              "type": "string"
+            },
+            "override_path": {
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "safe_to_retry_with_user_input": {
+        "const": true
+      },
+      "status": {
+        "const": "needs_input"
+      },
+      "user_instruction": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "status",
+      "user_instruction",
+      "safe_to_retry_with_user_input"
+    ]
+  },
+  {
+    "properties": {
+      "account_blocker_code": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "account_blocker_label": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "ad_account_id": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "ad_account_name": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "automatic_retry_allowed": {
+        "type": "boolean"
+      },
+      "category": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "code": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "invalid_fields": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "manual_new_task_allowed": {
+        "type": "boolean"
+      },
+      "narrative": {
+        "properties": {
+          "details": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "headline": {
+            "type": "string"
+          },
+          "summary": {
+            "type": "string"
+          },
+          "user_instruction": {
+            "type": "string"
+          },
+          "what_happens_next": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "operator_review_required": {
+        "type": "boolean"
+      },
+      "status": {
+        "const": "blocked"
+      },
+      "warnings": {
+        "$ref": "#/$defs/s2"
+      }
+    },
+    "required": [
+      "status",
+      "narrative"
+    ]
+  }
+]

Changed1 schema field changedOct 8, 2026

changedOutput schema / else / else / anyOf

Previous value: -[
-  {
-    "properties": {
-      "approval_request": {
-        "properties": {
-          "approval_ref": {
-            "type": "string"
-          },
-          "confirm_token": {
-            "type": "string"
-          },
-          "expires_at": {
-            "type": "string"
-          },
-          "mode": {
-            "type": "string"
-          },
-          "plan_digest": {
-            "type": "string"
-          },
-          "schema_version": {
-            "type": "integer"
-          },
-          "status": {
-            "const": "approval_required"
-          },
-          "summary": {
-            "properties": {
-              "account_currency": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "action": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "ad_account_id": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "ad_count": {
-                "type": "integer"
-              },
-              "ad_id": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "ad_name_after": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "ad_name_before": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "ad_status": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "adset_count": {
-                "type": "integer"
-              },
-              "adset_id": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "adset_status": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "bid": {
-                "$ref": "#/$defs/s0"
-              },
-              "budget": {
-                "$ref": "#/$defs/s0"
-              },
-              "campaign_count": {
-                "type": "integer"
-              },
-              "campaign_id": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "campaign_status": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "change_percent": {
-                "type": [
-                  "number",
-                  "null"
-                ]
-              },
-              "copies": {
-                "type": "integer"
-              },
-              "count": {
-                "type": "integer"
-              },
-              "creative_after": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "creative_before": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "cross_account": {
-                "type": "boolean"
-              },
-              "current_daily_budget": {
-                "type": [
-                  "number",
-                  "null"
-                ]
-              },
-              "engagement_mode": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "entity_id": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "entity_type": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "groups": {
-                "items": {
-                  "properties": {
-                    "adsets": {
-                      "items": {
-                        "properties": {
-                          "name": {
-                            "type": [
-                              "string",
-                              "null"
-                            ]
-                          },
-                          "target_adset_id": {
-                            "type": [
-                              "string",
-                              "null"
-                            ]
-                          }
-                        },
-                        "type": "object"
-                      },
-                      "type": "array"
-                    },
-                    "bid": {
-                      "$ref": "#/$defs/s1"
-                    },
-                    "budget": {
-                      "$ref": "#/$defs/s1"
-                    },
-                    "campaign_name": {
-                      "type": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "layout": {
-                      "type": "string"
-                    }
-                  },
-                  "type": "object"
-                },
-                "type": "array"
-              },
-              "items": {
-                "items": {
-                  "properties": {
-                    "ad_account_id": {
-                      "type": "string"
-                    },
-                    "ad_id": {
-                      "type": "string"
-                    },
-                    "campaign_id": {
-                      "type": "string"
-                    },
-                    "current_configured_status": {
-                      "type": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "current_daily_budget": {
-                      "type": [
-                        "number",
-                        "null"
-                      ]
-                    },
-                    "new_daily_budget": {
-                      "type": [
-                        "number",
-                        "null"
-                      ]
-                    },
-                    "target_configured_status": {
-                      "type": "string"
-                    }
-                  },
-                  "type": "object"
-                },
-                "type": "array"
-              },
-              "mode": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "new_daily_budget": {
-                "type": [
-                  "number",
-                  "null"
-                ]
-              },
-              "note": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "page_id_after": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "page_id_before": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "publish_start_label": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "source_ad_account_id": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "source_ad_id": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "source_id": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "source_level": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "source_name": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "statuses": {
-                "properties": {
-                  "ad": {
-                    "type": [
-                      "string",
-                      "null"
-                    ]
-                  },
-                  "adset": {
-                    "type": [
-                      "string",
-                      "null"
-                    ]
-                  },
-                  "campaign": {
-                    "type": [
-                      "string",
-                      "null"
-                    ]
-                  }
-                },
-                "type": "object"
-              },
-              "structure": {
-                "properties": {
-                  "ads": {
-                    "type": "integer"
-                  },
-                  "adsets": {
-                    "type": "integer"
-                  },
-                  "auxiliary_writes": {
-                    "type": "integer"
-                  },
-                  "campaigns": {
-                    "type": "integer"
-                  },
-                  "creative_keys": {
-                    "type": "integer"
-                  },
-                  "layouts": {
-                    "items": {
-                      "type": "string"
-                    },
-                    "type": "array"
-                  }
-                },
-                "type": "object"
-              },
-              "target_ad_account_id": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "template_name": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "warnings": {
-                "$ref": "#/$defs/s2"
-              }
-            },
-            "type": "object"
-          },
-          "tool_name": {
-            "type": "string"
-          },
-          "user_instruction": {
-            "type": "string"
-          },
-          "warnings": {
-            "$ref": "#/$defs/s2"
-          }
-        },
-        "required": [
-          "status",
-          "confirm_token",
-          "expires_at",
-          "summary"
-        ],
-        "type": "object"
-      },
-      "status": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "approval_request"
-    ]
-  },
-  {
-    "properties": {
-      "missing_requirements": {
-        "items": {
-          "properties": {
-            "field": {
-              "type": "string"
-            },
-            "message": {
-              "type": "string"
-            },
-            "override_path": {
-              "type": "string"
-            }
-          },
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "safe_to_retry_with_user_input": {
-        "const": true
-      },
-      "status": {
-        "const": "needs_input"
-      },
-      "user_instruction": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "status",
-      "user_instruction",
-      "safe_to_retry_with_user_input"
-    ]
-  },
-  {
-    "properties": {
-      "account_blocker_code": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "account_blocker_label": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "ad_account_id": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "ad_account_name": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "automatic_retry_allowed": {
-        "type": "boolean"
-      },
-      "category": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "code": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "invalid_fields": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "manual_new_task_allowed": {
-        "type": "boolean"
-      },
-      "narrative": {
-        "properties": {
-          "details": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "headline": {
-            "type": "string"
-          },
-          "summary": {
-            "type": "string"
-          },
-          "user_instruction": {
-            "type": "string"
-          },
-          "what_happens_next": {
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "operator_review_required": {
-        "type": "boolean"
-      },
-      "status": {
-        "const": "blocked"
-      },
-      "warnings": {
-        "$ref": "#/$defs/s2"
-      }
-    },
-    "required": [
-      "status",
-      "narrative"
-    ]
-  }
-]New value: +[
+  {
+    "properties": {
+      "approval_request": {
+        "properties": {
+          "approval_ref": {
+            "type": "string"
+          },
+          "confirm_token": {
+            "type": "string"
+          },
+          "expires_at": {
+            "type": "string"
+          },
+          "mode": {
+            "type": "string"
+          },
+          "plan_digest": {
+            "type": "string"
+          },
+          "schema_version": {
+            "type": "integer"
+          },
+          "status": {
+            "const": "approval_required"
+          },
+          "summary": {
+            "properties": {
+              "account_currency": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "action": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "ad_account_id": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "ad_count": {
+                "type": "integer"
+              },
+              "ad_id": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "ad_name_after": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "ad_name_before": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "ad_status": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "adset_count": {
+                "type": "integer"
+              },
+              "adset_id": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "adset_status": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "bid": {
+                "$ref": "#/$defs/s0"
+              },
+              "budget": {
+                "$ref": "#/$defs/s0"
+              },
+              "campaign_count": {
+                "type": "integer"
+              },
+              "campaign_id": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "campaign_status": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "change_percent": {
+                "type": [
+                  "number",
+                  "null"
+                ]
+              },
+              "copies": {
+                "type": "integer"
+              },
+              "count": {
+                "type": "integer"
+              },
+              "creative_after": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "creative_before": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "cross_account": {
+                "type": "boolean"
+              },
+              "current_daily_budget": {
+                "type": [
+                  "number",
+                  "null"
+                ]
+              },
+              "engagement_mode": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "entity_id": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "entity_type": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "groups": {
+                "items": {
+                  "properties": {
+                    "adsets": {
+                      "items": {
+                        "properties": {
+                          "name": {
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          },
+                          "target_adset_id": {
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          }
+                        },
+                        "type": "object"
+                      },
+                      "type": "array"
+                    },
+                    "bid": {
+                      "$ref": "#/$defs/s1"
+                    },
+                    "budget": {
+                      "$ref": "#/$defs/s1"
+                    },
+                    "campaign_name": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "layout": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "items": {
+                "items": {
+                  "properties": {
+                    "ad_account_id": {
+                      "type": "string"
+                    },
+                    "ad_id": {
+                      "type": "string"
+                    },
+                    "campaign_id": {
+                      "type": "string"
+                    },
+                    "current_configured_status": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "current_daily_budget": {
+                      "type": [
+                        "number",
+                        "null"
+                      ]
+                    },
+                    "new_daily_budget": {
+                      "type": [
+                        "number",
+                        "null"
+                      ]
+                    },
+                    "target_configured_status": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "mode": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "new_daily_budget": {
+                "type": [
+                  "number",
+                  "null"
+                ]
+              },
+              "note": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "page_id_after": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "page_id_before": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "preflight": {
+                "properties": {
+                  "ad_account_id": {
+                    "type": "string"
+                  },
+                  "billing": {
+                    "properties": {
+                      "available_funds_major": {
+                        "type": [
+                          "number",
+                          "null"
+                        ]
+                      },
+                      "balance_semantics": {
+                        "type": "string"
+                      },
+                      "currency": {
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "low_remaining_spend_cap": {
+                        "type": "boolean"
+                      },
+                      "note": {
+                        "type": "string"
+                      },
+                      "reported_balance_major": {
+                        "type": [
+                          "number",
+                          "null"
+                        ]
+                      },
+                      "spend_cap_remaining_major": {
+                        "type": [
+                          "number",
+                          "null"
+                        ]
+                      }
+                    },
+                    "type": "object"
+                  },
+                  "checked_at": {
+                    "type": "string"
+                  },
+                  "checks": {
+                    "items": {
+                      "properties": {
+                        "asset_id": {
+                          "type": "string"
+                        },
+                        "asset_type": {
+                          "type": "string"
+                        },
+                        "message": {
+                          "type": "string"
+                        },
+                        "status": {
+                          "type": "string"
+                        }
+                      },
+                      "type": "object"
+                    },
+                    "type": "array"
+                  },
+                  "status": {
+                    "type": "string"
+                  },
+                  "timing": {
+                    "properties": {
+                      "account_local_now": {
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "hours_left_today": {
+                        "type": [
+                          "number",
+                          "null"
+                        ]
+                      },
+                      "note": {
+                        "type": "string"
+                      },
+                      "schedule_valid": {
+                        "type": "boolean"
+                      },
+                      "timezone_name": {
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "utc_offset_hours": {
+                        "type": "number"
+                      },
+                      "windows": {
+                        "items": {
+                          "properties": {
+                            "end_time": {
+                              "type": [
+                                "string",
+                                "null"
+                              ]
+                            },
+                            "hours_remaining": {
+                              "type": [
+                                "number",
+                                "null"
+                              ]
+                            },
+                            "hours_until_start": {
+                              "type": "number"
+                            },
+                            "paused": {
+                              "type": "boolean"
+                            },
+                            "potential_delivery_hours_today": {
+                              "type": "number"
+                            },
+                            "start_time": {
+                              "type": [
+                                "string",
+                                "null"
+                              ]
+                            }
+                          },
+                          "type": "object"
+                        },
+                        "type": "array"
+                      }
+                    },
+                    "type": "object"
+                  },
+                  "version": {
+                    "type": "integer"
+                  },
+                  "warnings": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  }
+                },
+                "required": [
+                  "version",
+                  "checked_at",
+                  "ad_account_id",
+                  "status",
+                  "checks",
+                  "warnings"
+                ],
+                "type": "object"
+              },
+              "publish_start_label": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "source_ad_account_id": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "source_ad_id": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "source_id": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "source_level": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "source_name": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "statuses": {
+                "properties": {
+                  "ad": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "adset": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "campaign": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  }
+                },
+                "type": "object"
+              },
+              "structure": {
+                "properties": {
+                  "ads": {
+                    "type": "integer"
+                  },
+                  "adsets": {
+                    "type": "integer"
+                  },
+                  "auxiliary_writes": {
+                    "type": "integer"
+                  },
+                  "campaigns": {
+                    "type": "integer"
+                  },
+                  "creative_keys": {
+                    "type": "integer"
+                  },
+                  "layouts": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  }
+                },
+                "type": "object"
+              },
+              "target_ad_account_id": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "template_name": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "warnings": {
+                "$ref": "#/$defs/s2"
+              }
+            },
+            "type": "object"
+          },
+          "tool_name": {
+            "type": "string"
+          },
+          "user_instruction": {
+            "type": "string"
+          },
+          "warnings": {
+            "$ref": "#/$defs/s2"
+          }
+        },
+        "required": [
+          "status",
+          "confirm_token",
+          "expires_at",
+          "summary"
+        ],
+        "type": "object"
+      },
+      "status": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "approval_request"
+    ]
+  },
+  {
+    "properties": {
+      "missing_requirements": {
+        "items": {
+          "properties": {
+            "field": {
+              "type": "string"
+            },
+            "message": {
+              "type": "string"
+            },
+            "override_path": {
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "safe_to_retry_with_user_input": {
+        "const": true
+      },
+      "status": {
+        "const": "needs_input"
+      },
+      "user_instruction": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "status",
+      "user_instruction",
+      "safe_to_retry_with_user_input"
+    ]
+  },
+  {
+    "properties": {
+      "account_blocker_code": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "account_blocker_label": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "ad_account_id": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "ad_account_name": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "automatic_retry_allowed": {
+        "type": "boolean"
+      },
+      "category": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "code": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "invalid_fields": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "manual_new_task_allowed": {
+        "type": "boolean"
+      },
+      "narrative": {
+        "properties": {
+          "details": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "headline": {
+            "type": "string"
+          },
+          "summary": {
+            "type": "string"
+          },
+          "user_instruction": {
+            "type": "string"
+          },
+          "what_happens_next": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "operator_review_required": {
+        "type": "boolean"
+      },
+      "status": {
+        "const": "blocked"
+      },
+      "warnings": {
+        "$ref": "#/$defs/s2"
+      }
+    },
+    "required": [
+      "status",
+      "narrative"
+    ]
+  }
+]

Changed2 schema fields changedOct 5, 2026

addedOutput schema / $defs / s2

Added value: +{
+  "items": {
+    "anyOf": [
+      {
+        "type": "string"
+      },
+      {
+        "anyOf": [
+          {
+            "properties": {
+              "code": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "code"
+            ]
+          },
+          {
+            "required": [
+              "message"
+            ]
+          }
+        ],
+        "properties": {
+          "message": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      }
+    ]
+  },
+  "type": "array"
+}

changedOutput schema / else / else / anyOf

Previous value: -[
-  {
-    "properties": {
-      "approval_request": {
-        "properties": {
-          "approval_ref": {
-            "type": "string"
-          },
-          "confirm_token": {
-            "type": "string"
-          },
-          "expires_at": {
-            "type": "string"
-          },
-          "mode": {
-            "type": "string"
-          },
-          "plan_digest": {
-            "type": "string"
-          },
-          "schema_version": {
-            "type": "integer"
-          },
-          "status": {
-            "const": "approval_required"
-          },
-          "summary": {
-            "properties": {
-              "account_currency": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "action": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "ad_account_id": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "ad_count": {
-                "type": "integer"
-              },
-              "ad_id": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "ad_name_after": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "ad_name_before": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "ad_status": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "adset_count": {
-                "type": "integer"
-              },
-              "adset_id": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "adset_status": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "bid": {
-                "$ref": "#/$defs/s0"
-              },
-              "budget": {
-                "$ref": "#/$defs/s0"
-              },
-              "campaign_count": {
-                "type": "integer"
-              },
-              "campaign_id": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "campaign_status": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "change_percent": {
-                "type": [
-                  "number",
-                  "null"
-                ]
-              },
-              "copies": {
-                "type": "integer"
-              },
-              "count": {
-                "type": "integer"
-              },
-              "creative_after": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "creative_before": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "cross_account": {
-                "type": "boolean"
-              },
-              "current_daily_budget": {
-                "type": [
-                  "number",
-                  "null"
-                ]
-              },
-              "engagement_mode": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "entity_id": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "entity_type": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "groups": {
-                "items": {
-                  "properties": {
-                    "adsets": {
-                      "items": {
-                        "properties": {
-                          "name": {
-                            "type": [
-                              "string",
-                              "null"
-                            ]
-                          },
-                          "target_adset_id": {
-                            "type": [
-                              "string",
-                              "null"
-                            ]
-                          }
-                        },
-                        "type": "object"
-                      },
-                      "type": "array"
-                    },
-                    "bid": {
-                      "$ref": "#/$defs/s1"
-                    },
-                    "budget": {
-                      "$ref": "#/$defs/s1"
-                    },
-                    "campaign_name": {
-                      "type": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "layout": {
-                      "type": "string"
-                    }
-                  },
-                  "type": "object"
-                },
-                "type": "array"
-              },
-              "items": {
-                "items": {
-                  "properties": {
-                    "ad_account_id": {
-                      "type": "string"
-                    },
-                    "ad_id": {
-                      "type": "string"
-                    },
-                    "campaign_id": {
-                      "type": "string"
-                    },
-                    "current_configured_status": {
-                      "type": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "current_daily_budget": {
-                      "type": [
-                        "number",
-                        "null"
-                      ]
-                    },
-                    "new_daily_budget": {
-                      "type": [
-                        "number",
-                        "null"
-                      ]
-                    },
-                    "target_configured_status": {
-                      "type": "string"
-                    }
-                  },
-                  "type": "object"
-                },
-                "type": "array"
-              },
-              "mode": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "new_daily_budget": {
-                "type": [
-                  "number",
-                  "null"
-                ]
-              },
-              "note": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "page_id_after": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "page_id_before": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "publish_start_label": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "source_ad_account_id": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "source_ad_id": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "source_id": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "source_level": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "source_name": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "statuses": {
-                "properties": {
-                  "ad": {
-                    "type": [
-                      "string",
-                      "null"
-                    ]
-                  },
-                  "adset": {
-                    "type": [
-                      "string",
-                      "null"
-                    ]
-                  },
-                  "campaign": {
-                    "type": [
-                      "string",
-                      "null"
-                    ]
-                  }
-                },
-                "type": "object"
-              },
-              "structure": {
-                "properties": {
-                  "ads": {
-                    "type": "integer"
-                  },
-                  "adsets": {
-                    "type": "integer"
-                  },
-                  "auxiliary_writes": {
-                    "type": "integer"
-                  },
-                  "campaigns": {
-                    "type": "integer"
-                  },
-                  "creative_keys": {
-                    "type": "integer"
-                  },
-                  "layouts": {
-                    "items": {
-                      "type": "string"
-                    },
-                    "type": "array"
-                  }
-                },
-                "type": "object"
-              },
-              "target_ad_account_id": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "template_name": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "warnings": {
-                "items": {
-                  "anyOf": [
-                    {
-                      "type": "string"
-                    },
-                    {
-                      "anyOf": [
-                        {
-                          "properties": {
-                            "code": {
-                              "type": "string"
-                            }
-                          },
-                          "required": [
-                            "code"
-                          ]
-                        },
-                        {
-                          "required": [
-                            "message"
-                          ]
-                        }
-                      ],
-                      "properties": {
-                        "message": {
-                          "type": "string"
-                        }
-                      },
-                      "type": "object"
-                    }
-                  ]
-                },
-                "type": "array"
-              }
-            },
-            "type": "object"
-          },
-          "tool_name": {
-            "type": "string"
-          },
-          "user_instruction": {
-            "type": "string"
-          },
-          "warnings": {
-            "items": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "anyOf": [
-                    {
-                      "properties": {
-                        "code": {
-                          "type": "string"
-                        }
-                      },
-                      "required": [
-                        "code"
-                      ]
-                    },
-                    {
-                      "required": [
-                        "message"
-                      ]
-                    }
-                  ],
-                  "properties": {
-                    "message": {
-                      "type": "string"
-                    }
-                  },
-                  "type": "object"
-                }
-              ]
-            },
-            "type": "array"
-          }
-        },
-        "required": [
-          "status",
-          "confirm_token",
-          "expires_at",
-          "summary"
-        ],
-        "type": "object"
-      },
-      "status": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "approval_request"
-    ]
-  },
-  {
-    "properties": {
-      "missing_requirements": {
-        "items": {
-          "properties": {
-            "field": {
-              "type": "string"
-            },
-            "message": {
-              "type": "string"
-            },
-            "override_path": {
-              "type": "string"
-            }
-          },
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "safe_to_retry_with_user_input": {
-        "const": true
-      },
-      "status": {
-        "const": "needs_input"
-      },
-      "user_instruction": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "status",
-      "user_instruction",
-      "safe_to_retry_with_user_input"
-    ]
-  }
-]New value: +[
+  {
+    "properties": {
+      "approval_request": {
+        "properties": {
+          "approval_ref": {
+            "type": "string"
+          },
+          "confirm_token": {
+            "type": "string"
+          },
+          "expires_at": {
+            "type": "string"
+          },
+          "mode": {
+            "type": "string"
+          },
+          "plan_digest": {
+            "type": "string"
+          },
+          "schema_version": {
+            "type": "integer"
+          },
+          "status": {
+            "const": "approval_required"
+          },
+          "summary": {
+            "properties": {
+              "account_currency": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "action": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "ad_account_id": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "ad_count": {
+                "type": "integer"
+              },
+              "ad_id": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "ad_name_after": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "ad_name_before": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "ad_status": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "adset_count": {
+                "type": "integer"
+              },
+              "adset_id": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "adset_status": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "bid": {
+                "$ref": "#/$defs/s0"
+              },
+              "budget": {
+                "$ref": "#/$defs/s0"
+              },
+              "campaign_count": {
+                "type": "integer"
+              },
+              "campaign_id": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "campaign_status": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "change_percent": {
+                "type": [
+                  "number",
+                  "null"
+                ]
+              },
+              "copies": {
+                "type": "integer"
+              },
+              "count": {
+                "type": "integer"
+              },
+              "creative_after": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "creative_before": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "cross_account": {
+                "type": "boolean"
+              },
+              "current_daily_budget": {
+                "type": [
+                  "number",
+                  "null"
+                ]
+              },
+              "engagement_mode": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "entity_id": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "entity_type": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "groups": {
+                "items": {
+                  "properties": {
+                    "adsets": {
+                      "items": {
+                        "properties": {
+                          "name": {
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          },
+                          "target_adset_id": {
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          }
+                        },
+                        "type": "object"
+                      },
+                      "type": "array"
+                    },
+                    "bid": {
+                      "$ref": "#/$defs/s1"
+                    },
+                    "budget": {
+                      "$ref": "#/$defs/s1"
+                    },
+                    "campaign_name": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "layout": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "items": {
+                "items": {
+                  "properties": {
+                    "ad_account_id": {
+                      "type": "string"
+                    },
+                    "ad_id": {
+                      "type": "string"
+                    },
+                    "campaign_id": {
+                      "type": "string"
+                    },
+                    "current_configured_status": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "current_daily_budget": {
+                      "type": [
+                        "number",
+                        "null"
+                      ]
+                    },
+                    "new_daily_budget": {
+                      "type": [
+                        "number",
+                        "null"
+                      ]
+                    },
+                    "target_configured_status": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "mode": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "new_daily_budget": {
+                "type": [
+                  "number",
+                  "null"
+                ]
+              },
+              "note": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "page_id_after": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "page_id_before": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "publish_start_label": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "source_ad_account_id": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "source_ad_id": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "source_id": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "source_level": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "source_name": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "statuses": {
+                "properties": {
+                  "ad": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "adset": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "campaign": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  }
+                },
+                "type": "object"
+              },
+              "structure": {
+                "properties": {
+                  "ads": {
+                    "type": "integer"
+                  },
+                  "adsets": {
+                    "type": "integer"
+                  },
+                  "auxiliary_writes": {
+                    "type": "integer"
+                  },
+                  "campaigns": {
+                    "type": "integer"
+                  },
+                  "creative_keys": {
+                    "type": "integer"
+                  },
+                  "layouts": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  }
+                },
+                "type": "object"
+              },
+              "target_ad_account_id": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "template_name": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "warnings": {
+                "$ref": "#/$defs/s2"
+              }
+            },
+            "type": "object"
+          },
+          "tool_name": {
+            "type": "string"
+          },
+          "user_instruction": {
+            "type": "string"
+          },
+          "warnings": {
+            "$ref": "#/$defs/s2"
+          }
+        },
+        "required": [
+          "status",
+          "confirm_token",
+          "expires_at",
+          "summary"
+        ],
+        "type": "object"
+      },
+      "status": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "approval_request"
+    ]
+  },
+  {
+    "properties": {
+      "missing_requirements": {
+        "items": {
+          "properties": {
+            "field": {
+              "type": "string"
+            },
+            "message": {
+              "type": "string"
+            },
+            "override_path": {
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "safe_to_retry_with_user_input": {
+        "const": true
+      },
+      "status": {
+        "const": "needs_input"
+      },
+      "user_instruction": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "status",
+      "user_instruction",
+      "safe_to_retry_with_user_input"
+    ]
+  },
+  {
+    "properties": {
+      "account_blocker_code": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "account_blocker_label": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "ad_account_id": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "ad_account_name": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "automatic_retry_allowed": {
+        "type": "boolean"
+      },
+      "category": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "code": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "invalid_fields": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "manual_new_task_allowed": {
+        "type": "boolean"
+      },
+      "narrative": {
+        "properties": {
+          "details": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "headline": {
+            "type": "string"
+          },
+          "summary": {
+            "type": "string"
+          },
+          "user_instruction": {
+            "type": "string"
+          },
+          "what_happens_next": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "operator_review_required": {
+        "type": "boolean"
+      },
+      "status": {
+        "const": "blocked"
+      },
+      "warnings": {
+        "$ref": "#/$defs/s2"
+      }
+    },
+    "required": [
+      "status",
+      "narrative"
+    ]
+  }
+]

Changed3 schema fields changedSep 16, 2026

addedInput schema / properties / request / properties / creative_source / properties / carousel_groups / items / properties / title
```
Added value: +{
+  "maxLength": 500,
+  "type": "string"
+}
```

addedInput schema / properties / request / properties / creative_source / properties / creative_overrides

Added value: +{
+  "items": {
+    "additionalProperties": false,
+    "oneOf": [
+      {
+        "properties": {
+          "creative_name": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "creative_name"
+        ]
+      }
+    ],
+    "properties": {
+      "body": {
+        "maxLength": 5000,
+        "type": "string"
+      },
+      "creative_name": {
+        "maxLength": 500,
+        "minLength": 1,
+        "type": "string"
+      },
+      "deeplink": {
+        "maxLength": 2048,
+        "type": "string"
+      },
+      "description": {
+        "maxLength": 500,
+        "type": "string"
+      },
+      "title": {
+        "maxLength": 500,
+        "type": "string"
+      }
+    },
+    "type": "object"
+  },
+  "maxItems": 50,
+  "type": "array"
+}

addedInput schema / properties / request / properties / overrides / properties / title
```
Added value: +{
+  "maxLength": 500,
+  "type": "string"
+}
```

Changed3 schema fields changedSep 16, 2026
- addedInput schema / properties / request / properties / creative_source / properties / carousel_groups / items / properties / body
```
Added value: +{
+  "maxLength": 5000,
+  "type": "string"
+}
```
- addedInput schema / properties / request / properties / creative_source / properties / carousel_groups / items / properties / description
```
Added value: +{
+  "maxLength": 500,
+  "type": "string"
+}
```
- addedInput schema / properties / request / properties / overrides / properties / description
```
Added value: +{
+  "maxLength": 500,
+  "type": "string"
+}
```

Changed1 schema field changedSep 15, 2026

addedInput schema / properties / request / properties / overrides / properties / instagram_user_id

Added value: +{
+  "description": "IG ID from accounts_list_instagram_accounts; omit to inherit, empty string uses Page identity.",
+  "pattern": "^[0-9]{0,32}$",
+  "type": "string"
+}

Changed1 schema field changedSep 10, 2026

changedInput schema / properties / request / properties / creative_source / properties / mode / enum

Previous value: -[
-  "creative",
-  "partnership",
-  "template_source",
-  "carousel"
-]New value: +[
+  "creative",
+  "template_source",
+  "carousel"
+]

Changed2 schema fields changedSep 10, 2026

changedInput schema / properties / request / properties / creative_source / oneOf

Previous value: -[
-  {
-    "properties": {
-      "ad_name": {
-        "type": "null"
-      },
-      "creative_names": {
-        "minItems": 1
-      },
-      "mode": {
-        "const": "creative"
-      }
-    },
-    "propertyNames": {
-      "pattern": "^(m|cr)"
-    },
-    "required": [
-      "creative_names"
-    ]
-  },
-  {
-    "properties": {
-      "ad_name": {
-        "type": "null"
-      },
-      "mode": {
-        "const": "partnership"
-      },
-      "partnership_rows": {
-        "minItems": 1
-      }
-    },
-    "propertyNames": {
-      "pattern": "^[mp]"
-    },
-    "required": [
-      "mode",
-      "partnership_rows"
-    ]
-  },
-  {
-    "properties": {
-      "media_mode": {
-        "const": "single"
-      },
-      "mode": {
-        "const": "template_source"
-      }
-    },
-    "propertyNames": {
-      "pattern": "^(m|a)"
-    },
-    "required": [
-      "mode"
-    ]
-  },
-  {
-    "properties": {
-      "ad_name": {
-        "type": "null"
-      },
-      "carousel_groups": {
-        "minItems": 1
-      },
-      "mode": {
-        "const": "carousel"
-      }
-    },
-    "propertyNames": {
-      "pattern": "^(m|ca)"
-    },
-    "required": [
-      "mode",
-      "carousel_groups"
-    ]
-  }
-]New value: +[
+  {
+    "properties": {
+      "ad_name": {
+        "type": "null"
+      },
+      "creative_names": {
+        "minItems": 1
+      },
+      "mode": {
+        "const": "creative"
+      }
+    },
+    "propertyNames": {
+      "pattern": "^(m|cr)"
+    },
+    "required": [
+      "creative_names"
+    ]
+  },
+  {
+    "properties": {
+      "media_mode": {
+        "const": "single"
+      },
+      "mode": {
+        "const": "template_source"
+      }
+    },
+    "propertyNames": {
+      "pattern": "^(m|a)"
+    },
+    "required": [
+      "mode"
+    ]
+  },
+  {
+    "properties": {
+      "ad_name": {
+        "type": "null"
+      },
+      "carousel_groups": {
+        "minItems": 1
+      },
+      "mode": {
+        "const": "carousel"
+      }
+    },
+    "propertyNames": {
+      "pattern": "^(m|ca)"
+    },
+    "required": [
+      "mode",
+      "carousel_groups"
+    ]
+  }
+]

removedInput schema / properties / request / properties / creative_source / properties / partnership_rows

Removed value: -{
-  "items": {
-    "additionalProperties": false,
-    "properties": {
-      "ad_code": {
-        "maxLength": 4096,
-        "minLength": 1,
-        "type": "string"
-      },
-      "ad_name": {
-        "maxLength": 500,
-        "minLength": 1,
-        "type": "string"
-      },
-      "deeplink": {
-        "maxLength": 2048,
-        "type": "string"
-      }
-    },
-    "required": [
-      "ad_code",
-      "ad_name"
-    ],
-    "type": "object"
-  },
-  "maxItems": 50,
-  "type": "array"
-}

First observedSep 9, 2026

TDQS

A3.8/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations declare readOnlyHint=false and destructiveHint=false, so the description's job is to add context. It discloses the important behavioral trait that this only builds a draft requiring approval before launch_confirm executes, and that the original link_id should be reused when exposed. It does not cover collision handling, idempotency, or failure behavior for such a large mutation, so not a 5.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Four compact sentences, front-loaded with the action and scope before the alternative and the approval flow. There is one run-on with a missing break ("...after approval Use the workflow's original link_id...") that slightly harms readability, but no filler.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists so return values need not be described, and the safety profile is in annotations. For a tool with a very large nested schema (~30 request fields, multiple policies and modes), the high-level workflow guidance leaves gaps around append-mode semantics, target ID selection, and collision/partial policies. Adequate, but thin relative to the tool's complexity.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0% at the parameter level, so the description must compensate. It names the most load-bearing fields (request.ad_account_id, template_name, creative_source) and tells the agent to set append_mode and target IDs explicitly, but does not explain the three append_mode values, the target_campaign_id/target_adset_id pairing, or the policy enums. Adding to the schema's own enum descriptions, this is minimally sufficient rather than rich.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource (prepare new ads / append to campaign or ad set) and names the sibling it is not for (copy_ad_quick_copy). The core inputs it relies on (ad_account_id, a saved template, one creative_source) are called out. It does not distinguish itself from the many other *_prepare tools in the sibling list, so it stops short of a 5.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives clear context: it is for new ads or appending, live-ad copies should route to copy_ad_quick_copy, and the draft must be reviewed and executed via launch_confirm. Missing explicit when-not conditions (e.g. versus campaigns_recreate_from_task or copy_ad_clone_structure), but the selection signal for the closest sibling is explicit.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All AdsAgent — Meta Ads MCP tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?