Soclo

Create standalone ad

soclo_ads_create_standalone_ad

Destructive

Create a standalone advertisement from the supplied creative, targeting and budget in the selected connected ad account. Quote first by calling without confirm:true. Show the returned spending preview and obtain owner approval before confirming with the same requestId. Retain that requestId for soclo_ads_operation_status after an uncertain result; never automatically repeat a purchase. Report the returned status without claiming the ad is live until active. Confirmed creation requests active status; platform review may delay delivery. Fields: soclo://tools/soclo_ads_create_standalone_ad.

Input Schema

Name	Required	Description
`confirm`	No	True only after owner approval of spending/deletion preview.
`payload`	Yes
`platform`	No
`accountId`	Yes
`requestId`	No	Reuse this request ID for confirmation and outcome recovery.
`parameters`	No
`adAccountId`	No	Advertiser/ad account selected from your Soclo connection.
`expectedCurrency`	No	Approved preview currency, e.g. GBP.
`expectedBudgetType`	No	Approved preview budget type: daily or lifetime.
`expectedBudgetAmount`	No	Approved preview amount; changes require a new preview.

Schema Changelog

Changes observed during successful MCP inspections.

Changed112 schema fields changedOct 25, 2026

addedInput schema / definitions

Added value: +{
+  "s1": {
+    "anyOf": [
+      {
+        "maxLength": 80,
+        "minLength": 1,
+        "type": "string"
+      },
+      {
+        "properties": {
+          "matchType": {
+            "enum": [
+              "exact",
+              "phrase",
+              "broad"
+            ],
+            "type": "string"
+          },
+          "text": {
+            "maxLength": 80,
+            "minLength": 1,
+            "type": "string"
+          }
+        },
+        "required": [
+          "text"
+        ],
+        "type": "object"
+      }
+    ]
+  },
+  "s2": {
+    "properties": {
+      "address": {
+        "type": "string"
+      },
+      "distanceUnit": {
+        "enum": [
+          "mile",
+          "kilometer"
+        ],
+        "type": "string"
+      },
+      "latitude": {
+        "maximum": 90,
+        "minimum": -90,
+        "type": "number"
+      },
+      "longitude": {
+        "maximum": 180,
+        "minimum": -180,
+        "type": "number"
+      },
+      "name": {
+        "type": "string"
+      },
+      "radius": {
+        "type": "number"
+      }
+    },
+    "required": [
+      "latitude",
+      "longitude",
+      "radius",
+      "distanceUnit"
+    ],
+    "type": "object"
+  },
+  "s3": {
+    "enum": [
+      "africa",
+      "asia",
+      "europe",
+      "north_america",
+      "south_america",
+      "oceania",
+      "central_america",
+      "caribbean",
+      "eea",
+      "euro_area",
+      "nafta",
+      "mercosur",
+      "afta",
+      "apec",
+      "gcc",
+      "cisfta",
+      "emerging_markets",
+      "itunes_app_store",
+      "android_free_store",
+      "android_paid_store"
+    ],
+    "type": "string"
+  },
+  "s4": {
+    "items": {
+      "minLength": 1,
+      "type": "string"
+    },
+    "minItems": 1,
+    "type": "array"
+  },
+  "s5": {
+    "anyOf": [
+      {
+        "type": "string"
+      },
+      {
+        "properties": {
+          "key": {
+            "type": "string"
+          },
+          "name": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "key"
+        ],
+        "type": "object"
+      }
+    ]
+  },
+  "s6": {
+    "items": {
+      "enum": [
+        "feed",
+        "right_hand_column",
+        "marketplace",
+        "video_feeds",
+        "story",
+        "search",
+        "instream_video",
+        "facebook_reels",
+        "facebook_reels_overlay",
+        "profile_feed",
+        "notification"
+      ],
+      "type": "string"
+    },
+    "type": "array"
+  },
+  "s7": {
+    "items": {
+      "minLength": 1,
+      "type": "string"
+    },
+    "minItems": 1,
+    "type": "array"
+  },
+  "s8": {
+    "items": {
+      "enum": [
+        "stream",
+        "story",
+        "explore",
+        "explore_home",
+        "reels",
+        "profile_feed",
+        "ig_search",
+        "profile_reels"
+      ],
+      "type": "string"
+    },
+    "type": "array"
+  },
+  "s9": {
+    "items": {
+      "properties": {
+        "key": {
+          "type": "string"
+        },
+        "name": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "key"
+      ],
+      "type": "object"
+    },
+    "type": "array"
+  }
+}

removedInput schema / properties / accountId / description
```
Removed value: -"The connected ad account in Soclo."
```
removedInput schema / properties / payload / properties / assetGroup / properties / descriptions / description
```
Removed value: -"At least one description must be 60 characters or fewer."
```
removedInput schema / properties / payload / properties / assetGroup / properties / finalUrl / description
```
Removed value: -"Required destination URL."
```
removedInput schema / properties / payload / properties / assetGroup / properties / name / description
```
Removed value: -"Defaults to the request name."
```
removedInput schema / properties / payload / properties / audienceId / description
```
Removed value: -"Custom audience ID for targeting"
```
removedInput schema / properties / payload / properties / boardId / description
```
Removed value: -"Pinterest only. Board ID (auto-creates if not provided)."
```
removedInput schema / properties / payload / properties / brandIdentity / properties / displayName / description
```
Removed value: -"Brand name shown above the ad on TikTok."
```
removedInput schema / properties / payload / properties / businessName / description
```
Removed value: -"Google Display only"
```
addedInput schema / properties / payload / properties / campaignNegativeKeywords / items / $ref
```
Added value: +"#/definitions/s1"
```

removedInput schema / properties / payload / properties / campaignNegativeKeywords / items / anyOf

Removed value: -[
-  {
-    "description": "Keyword text; defaults to BROAD match",
-    "maxLength": 80,
-    "minLength": 1,
-    "type": "string"
-  },
-  {
-    "properties": {
-      "matchType": {
-        "enum": [
-          "exact",
-          "phrase",
-          "broad"
-        ],
-        "type": "string"
-      },
-      "text": {
-        "maxLength": 80,
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "text"
-    ],
-    "type": "object"
-  }
-]

removedInput schema / properties / payload / properties / carouselCards / items / properties / description / description
```
Removed value: -"Card description, shown under the headline."
```
removedInput schema / properties / payload / properties / carouselCards / items / properties / headline / description
```
Removed value: -"Card headline, shown below the card image."
```

changedInput schema / properties / payload / properties / cities / items / anyOf

Previous value: -[
-  {
-    "type": "string"
-  },
-  {
-    "properties": {
-      "distance_unit": {
-        "description": "Unit for radius. Required if radius is set.",
-        "enum": [
-          "mile",
-          "kilometer"
-        ],
-        "type": "string"
-      },
-      "key": {
-        "type": "string"
-      },
-      "radius": {
-        "type": "number"
-      }
-    },
-    "required": [
-      "key"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "type": "string"
+  },
+  {
+    "properties": {
+      "distance_unit": {
+        "enum": [
+          "mile",
+          "kilometer"
+        ],
+        "type": "string"
+      },
+      "key": {
+        "type": "string"
+      },
+      "radius": {
+        "type": "number"
+      }
+    },
+    "required": [
+      "key"
+    ],
+    "type": "object"
+  }
+]

addedInput schema / properties / payload / properties / countryGroups / items / $ref
```
Added value: +"#/definitions/s3"
```

removedInput schema / properties / payload / properties / countryGroups / items / enum

Removed value: -[
-  "africa",
-  "asia",
-  "europe",
-  "north_america",
-  "south_america",
-  "oceania",
-  "central_america",
-  "caribbean",
-  "eea",
-  "euro_area",
-  "nafta",
-  "mercosur",
-  "afta",
-  "apec",
-  "gcc",
-  "cisfta",
-  "emerging_markets",
-  "itunes_app_store",
-  "android_free_store",
-  "android_paid_store"
-]

removedInput schema / properties / payload / properties / countryGroups / items / type
```
Removed value: -"string"
```
removedInput schema / properties / payload / properties / creatives / items / properties / imageUrl / description
```
Removed value: -"Image creative. Mutually exclusive with `video`."
```
removedInput schema / properties / payload / properties / demandGen / properties / adGroupName / description
```
Removed value: -"Defaults to the ad name."
```
removedInput schema / properties / payload / properties / demandGen / properties / audience / properties / ageRanges / items / properties / max / description
```
Removed value: -"Omit for no upper bound."
```
removedInput schema / properties / payload / properties / demandGen / properties / carouselCards / items / properties / finalUrl / description
```
Removed value: -"Defaults to demandGen.finalUrl."
```
removedInput schema / properties / payload / properties / demandGen / properties / carouselCards / items / properties / images / properties / landscape / description
```
Removed value: -"1.91:1."
```
removedInput schema / properties / payload / properties / demandGen / properties / carouselCards / items / properties / images / properties / portrait / description
```
Removed value: -"4:5."
```
removedInput schema / properties / payload / properties / demandGen / properties / carouselCards / items / properties / images / properties / square / description
```
Removed value: -"1:1."
```
removedInput schema / properties / payload / properties / demandGen / properties / descriptions / description
```
Removed value: -"A carousel ad takes exactly one."
```
removedInput schema / properties / payload / properties / demandGen / properties / headlines / description
```
Removed value: -"Distinct texts. A carousel ad takes exactly one."
```
removedInput schema / properties / payload / properties / demandGen / properties / images / properties / landscape / description
```
Removed value: -"1.91:1, at least 600x314."
```
removedInput schema / properties / payload / properties / demandGen / properties / images / properties / logo / description
```
Removed value: -"1:1, at least 128x128."
```
removedInput schema / properties / payload / properties / demandGen / properties / images / properties / portrait / description
```
Removed value: -"4:5, at least 480x600."
```
removedInput schema / properties / payload / properties / demandGen / properties / images / properties / square / description
```
Removed value: -"1:1, at least 300x300."
```
removedInput schema / properties / payload / properties / demandGen / properties / longHeadlines / description
```
Removed value: -"Video ads only, and required there."
```
removedInput schema / properties / payload / properties / demandGen / properties / youtubeVideoIds / description
```
Removed value: -"Makes the ad a video responsive ad."
```
removedInput schema / properties / payload / properties / dynamicCreative / properties / bodies / description
```
Removed value: -"Primary-text variations (the body copy)."
```
removedInput schema / properties / payload / properties / dynamicCreative / properties / callToActionTypes / description
```
Removed value: -"CTA-button variations. Required."
```
removedInput schema / properties / payload / properties / dynamicCreative / properties / descriptions / description
```
Removed value: -"Description (link caption) variations."
```
removedInput schema / properties / payload / properties / dynamicCreative / properties / titles / description
```
Removed value: -"Headline variations."
```
addedInput schema / properties / payload / properties / keywords / items / $ref
```
Added value: +"#/definitions/s1"
```

removedInput schema / properties / payload / properties / keywords / items / anyOf

Removed value: -[
-  {
-    "description": "Keyword text; defaults to BROAD match",
-    "maxLength": 80,
-    "minLength": 1,
-    "type": "string"
-  },
-  {
-    "properties": {
-      "matchType": {
-        "enum": [
-          "exact",
-          "phrase",
-          "broad"
-        ],
-        "type": "string"
-      },
-      "text": {
-        "maxLength": 80,
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "text"
-    ],
-    "type": "object"
-  }
-]

addedInput schema / properties / payload / properties / metros / items / $ref
```
Added value: +"#/definitions/s5"
```

removedInput schema / properties / payload / properties / metros / items / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "properties": {
-      "key": {
-        "type": "string"
-      },
-      "name": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "key"
-    ],
-    "type": "object"
-  }
-]

addedInput schema / properties / payload / properties / negativeKeywords / items / $ref
```
Added value: +"#/definitions/s1"
```

removedInput schema / properties / payload / properties / negativeKeywords / items / anyOf

Removed value: -[
-  {
-    "description": "Keyword text; defaults to BROAD match",
-    "maxLength": 80,
-    "minLength": 1,
-    "type": "string"
-  },
-  {
-    "properties": {
-      "matchType": {
-        "enum": [
-          "exact",
-          "phrase",
-          "broad"
-        ],
-        "type": "string"
-      },
-      "text": {
-        "maxLength": 80,
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "text"
-    ],
-    "type": "object"
-  }
-]

removedInput schema / properties / payload / properties / networkSettings / properties / searchPartners / description
```
Removed value: -"campaign.network_settings.target_search_network"
```
removedInput schema / properties / payload / properties / placementAssets / properties / rules / items / properties / imageUrl / description
```
Removed value: -"Image mode. The image to deliver for this rule's placements."
```
addedInput schema / properties / payload / properties / placementAssets / properties / rules / items / properties / placements / properties / facebookPositions / $ref
```
Added value: +"#/definitions/s6"
```

removed

Input schema / properties / payload / properties / placementAssets / properties / rules / items / properties / placements / properties / facebookPositions / items

Removed value: -{
-  "enum": [
-    "feed",
-    "right_hand_column",
-    "marketplace",
-    "video_feeds",
-    "story",
-    "search",
-    "instream_video",
-    "facebook_reels",
-    "facebook_reels_overlay",
-    "profile_feed",
-    "notification"
-  ],
-  "type": "string"
-}

removedInput schema / properties / payload / properties / placementAssets / properties / rules / items / properties / placements / properties / facebookPositions / type
```
Removed value: -"array"
```
addedInput schema / properties / payload / properties / placementAssets / properties / rules / items / properties / placements / properties / instagramPositions / $ref
```
Added value: +"#/definitions/s8"
```

removed

Input schema / properties / payload / properties / placementAssets / properties / rules / items / properties / placements / properties / instagramPositions / items

Removed value: -{
-  "enum": [
-    "stream",
-    "story",
-    "explore",
-    "explore_home",
-    "reels",
-    "profile_feed",
-    "ig_search",
-    "profile_reels"
-  ],
-  "type": "string"
-}

removedInput schema / properties / payload / properties / placementAssets / properties / rules / items / properties / placements / properties / instagramPositions / type
```
Removed value: -"array"
```
removedInput schema / properties / payload / properties / placementAssets / properties / rules / items / properties / videoUrl / description
```
Removed value: -"Video mode. The video to deliver for this rule's placements."
```
addedInput schema / properties / payload / properties / placements / properties / facebookPositions / $ref
```
Added value: +"#/definitions/s6"
```

removedInput schema / properties / payload / properties / placements / properties / facebookPositions / items

Removed value: -{
-  "enum": [
-    "feed",
-    "right_hand_column",
-    "marketplace",
-    "video_feeds",
-    "story",
-    "search",
-    "instream_video",
-    "facebook_reels",
-    "facebook_reels_overlay",
-    "profile_feed",
-    "notification"
-  ],
-  "type": "string"
-}

removedInput schema / properties / payload / properties / placements / properties / facebookPositions / type
```
Removed value: -"array"
```
addedInput schema / properties / payload / properties / placements / properties / instagramPositions / $ref
```
Added value: +"#/definitions/s8"
```

removedInput schema / properties / payload / properties / placements / properties / instagramPositions / items

Removed value: -{
-  "enum": [
-    "stream",
-    "story",
-    "explore",
-    "explore_home",
-    "reels",
-    "profile_feed",
-    "ig_search",
-    "profile_reels"
-  ],
-  "type": "string"
-}

removedInput schema / properties / payload / properties / placements / properties / instagramPositions / type
```
Removed value: -"array"
```

changedInput schema / properties / payload / properties / platformSpecificData / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "audienceExpansionEnabled": {
-        "description": "Enable LinkedIn audience expansion. Defaults to false.",
-        "type": "boolean"
-      },
-      "carousel": {
-        "additionalProperties": false,
-        "properties": {
-          "cards": {
-            "items": {
-              "additionalProperties": false,
-              "properties": {
-                "headline": {
-                  "description": "Card title. Falls back to the ad-level headline.",
-                  "type": "string"
-                },
-                "imageUrl": {
-                  "type": "string"
-                },
-                "landingUrl": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "imageUrl"
-              ],
-              "type": "object"
-            },
-            "maxItems": 10,
-            "minItems": 2,
-            "type": "array"
-          }
-        },
-        "required": [
-          "cards"
-        ],
-        "type": "object"
-      },
-      "connectedTelevisionOnly": {
-        "description": "Restrict delivery to Connected TV inventory.",
-        "type": "boolean"
-      },
-      "conversation": {
-        "additionalProperties": false,
-        "properties": {
-          "body": {
-            "description": "Optional intro body (HTML allowed).",
-            "type": "string"
-          },
-          "firstMessageId": {
-            "type": "string"
-          },
-          "footer": {
-            "description": "Terms shown at the bottom of the message.",
-            "type": "string"
-          },
-          "headline": {
-            "type": "string"
-          },
-          "messages": {
-            "items": {
-              "additionalProperties": false,
-              "properties": {
-                "buttons": {
-                  "items": {
-                    "additionalProperties": false,
-                    "properties": {
-                      "nextMessageId": {
-                        "type": "string"
-                      },
-                      "text": {
-                        "maxLength": 35,
-                        "type": "string"
-                      },
-                      "url": {
-                        "type": "string"
-                      }
-                    },
-                    "required": [
-                      "text"
-                    ],
-                    "type": "object"
-                  },
-                  "maxItems": 5,
-                  "minItems": 1,
-                  "type": "array"
-                },
-                "id": {
-                  "type": "string"
-                },
-                "text": {
-                  "maxLength": 500,
-                  "type": "string"
-                }
-              },
-              "required": [
-                "id",
-                "text"
-              ],
-              "type": "object"
-            },
-            "maxItems": 25,
-            "minItems": 1,
-            "type": "array"
-          },
-          "sender": {
-            "type": "string"
-          },
-          "subject": {
-            "description": "InMail subject shown in the inbox.",
-            "type": "string"
-          }
-        },
-        "required": [
-          "subject",
-          "firstMessageId",
-          "messages"
-        ],
-        "type": "object"
-      },
-      "costType": {
-        "enum": [
-          "CPM",
-          "CPC",
-          "CPV"
-        ],
-        "type": "string"
-      },
-      "creativeSelection": {
-        "enum": [
-          "OPTIMIZED",
-          "ROUND_ROBIN"
-        ],
-        "type": "string"
-      },
-      "document": {
-        "additionalProperties": false,
-        "properties": {
-          "title": {
-            "description": "Document title.",
-            "type": "string"
-          },
-          "url": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "url",
-          "title"
-        ],
-        "type": "object"
-      },
-      "event": {
-        "additionalProperties": false,
-        "properties": {
-          "urn": {
-            "description": "LinkedIn Event URN, urn:li:event:N.",
-            "pattern": "^urn:li:event:\\d+$",
-            "type": "string"
-          }
-        },
-        "required": [
-          "urn"
-        ],
-        "type": "object"
-      },
-      "follower": {
-        "additionalProperties": false,
-        "properties": {
-          "callToAction": {
-            "enum": [
-              "VISIT_ORGANIZATION_COMPANY_PAGE",
-              "VISIT_ORGANIZATION_LIFE_PAGE",
-              "VISIT_ORGANIZATION_JOBS_PAGE",
-              "VISIT_ORGANIZATION_CAREERS_PAGE"
-            ],
-            "type": "string"
-          },
-          "description": {
-            "additionalProperties": false,
-            "properties": {
-              "custom": {
-                "description": "Free text, reviewed by LinkedIn.",
-                "type": "string"
-              },
-              "preApproved": {
-                "type": "string"
-              }
-            },
-            "type": "object"
-          },
-          "headline": {
-            "additionalProperties": false,
-            "properties": {
-              "custom": {
-                "description": "Free text, reviewed by LinkedIn.",
-                "type": "string"
-              },
-              "preApproved": {
-                "type": "string"
-              }
-            },
-            "type": "object"
-          },
-          "logoUrl": {
-            "type": "string"
-          },
-          "organizationName": {
-            "type": "string"
-          },
-          "showMemberProfilePhoto": {
-            "description": "Defaults to true.",
-            "type": "boolean"
-          }
-        },
-        "required": [
-          "headline",
-          "description",
-          "callToAction"
-        ],
-        "type": "object"
-      },
-      "jobs": {
-        "additionalProperties": false,
-        "properties": {
-          "buttonLabel": {
-            "additionalProperties": false,
-            "properties": {
-              "custom": {
-                "description": "Free text, reviewed by LinkedIn.",
-                "type": "string"
-              },
-              "preApproved": {
-                "type": "string"
-              }
-            },
-            "type": "object"
-          },
-          "headline": {
-            "additionalProperties": false,
-            "properties": {
-              "custom": {
-                "description": "Free text, reviewed by LinkedIn.",
-                "type": "string"
-              },
-              "preApproved": {
-                "type": "string"
-              }
-            },
-            "type": "object"
-          },
-          "logoUrl": {
-            "type": "string"
-          },
-          "organizationName": {
-            "type": "string"
-          },
-          "showMemberProfilePhoto": {
-            "description": "Defaults to true.",
-            "type": "boolean"
-          }
-        },
-        "required": [
-          "headline",
-          "buttonLabel"
-        ],
-        "type": "object"
-      },
-      "offsiteDeliveryEnabled": {
-        "description": "Deliver on the LinkedIn Audience Network. Defaults to false.",
-        "type": "boolean"
-      },
-      "optimizationTargetType": {
-        "type": "string"
-      },
-      "spotlight": {
-        "additionalProperties": false,
-        "properties": {
-          "backgroundImageUrl": {
-            "type": "string"
-          },
-          "callToAction": {
-            "description": "Button label text.",
-            "type": "string"
-          },
-          "description": {
-            "description": "Mutually exclusive with backgroundImageUrl.",
-            "type": "string"
-          },
-          "headline": {
-            "type": "string"
-          },
-          "landingUrl": {
-            "type": "string"
-          },
-          "logoUrl": {
-            "type": "string"
-          },
-          "organizationName": {
-            "type": "string"
-          },
-          "showMemberProfilePhoto": {
-            "description": "Defaults to true.",
-            "type": "boolean"
-          }
-        },
-        "required": [
-          "headline",
-          "callToAction",
-          "landingUrl"
-        ],
-        "type": "object"
-      },
-      "textAd": {
-        "additionalProperties": false,
-        "properties": {
-          "description": {
-            "maxLength": 75,
-            "type": "string"
-          },
-          "headline": {
-            "maxLength": 25,
-            "type": "string"
-          },
-          "imageUrl": {
-            "description": "Optional 100x100 image.",
-            "type": "string"
-          },
-          "landingUrl": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "headline",
-          "description",
-          "landingUrl"
-        ],
-        "type": "object"
-      },
-      "thoughtLeader": {
-        "additionalProperties": false,
-        "properties": {
-          "postUrn": {
-            "pattern": "^urn:li:(share|ugcPost):\\d+$",
-            "type": "string"
-          }
-        },
-        "required": [
-          "postUrn"
-        ],
-        "type": "object"
-      },
-      "unitCost": {
-        "type": "number"
-      }
-    },
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "bidAmount": {
-        "type": "number"
-      },
-      "bidStrategy": {
-        "enum": [
-          "LOWEST_COST_WITHOUT_CAP",
-          "LOWEST_COST_WITH_BID_CAP",
-          "COST_CAP",
-          "LOWEST_COST_WITH_MIN_ROAS"
-        ],
-        "type": "string"
-      },
-      "customerLifecycle": {
-        "additionalProperties": false,
-        "properties": {
-          "engagedAudienceIds": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "existingCustomerAudienceIds": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "strategy": {
-            "enum": [
-              "all_customers",
-              "new_customers",
-              "new_customers_excluding_engaged"
-            ],
-            "type": "string"
-          }
-        },
-        "required": [
-          "strategy"
-        ],
-        "type": "object"
-      },
-      "dailyMinSpendTarget": {
-        "type": "number"
-      },
-      "lifetimeMinSpendTarget": {
-        "type": "number"
-      },
-      "roasAverageFloor": {
-        "type": "number"
-      }
-    },
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "audienceExpansionEnabled": {
+        "type": "boolean"
+      },
+      "carousel": {
+        "additionalProperties": false,
+        "properties": {
+          "cards": {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "headline": {
+                  "type": "string"
+                },
+                "imageUrl": {
+                  "type": "string"
+                },
+                "landingUrl": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "imageUrl"
+              ],
+              "type": "object"
+            },
+            "maxItems": 10,
+            "minItems": 2,
+            "type": "array"
+          }
+        },
+        "required": [
+          "cards"
+        ],
+        "type": "object"
+      },
+      "connectedTelevisionOnly": {
+        "type": "boolean"
+      },
+      "conversation": {
+        "additionalProperties": false,
+        "properties": {
+          "body": {
+            "type": "string"
+          },
+          "firstMessageId": {
+            "type": "string"
+          },
+          "footer": {
+            "type": "string"
+          },
+          "headline": {
+            "type": "string"
+          },
+          "messages": {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "buttons": {
+                  "items": {
+                    "additionalProperties": false,
+                    "properties": {
+                      "nextMessageId": {
+                        "type": "string"
+                      },
+                      "text": {
+                        "maxLength": 35,
+                        "type": "string"
+                      },
+                      "url": {
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "text"
+                    ],
+                    "type": "object"
+                  },
+                  "maxItems": 5,
+                  "minItems": 1,
+                  "type": "array"
+                },
+                "id": {
+                  "type": "string"
+                },
+                "text": {
+                  "maxLength": 500,
+                  "type": "string"
+                }
+              },
+              "required": [
+                "id",
+                "text"
+              ],
+              "type": "object"
+            },
+            "maxItems": 25,
+            "minItems": 1,
+            "type": "array"
+          },
+          "sender": {
+            "type": "string"
+          },
+          "subject": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "subject",
+          "firstMessageId",
+          "messages"
+        ],
+        "type": "object"
+      },
+      "costType": {
+        "enum": [
+          "CPM",
+          "CPC",
+          "CPV"
+        ],
+        "type": "string"
+      },
+      "creativeSelection": {
+        "enum": [
+          "OPTIMIZED",
+          "ROUND_ROBIN"
+        ],
+        "type": "string"
+      },
+      "document": {
+        "additionalProperties": false,
+        "properties": {
+          "title": {
+            "type": "string"
+          },
+          "url": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "url",
+          "title"
+        ],
+        "type": "object"
+      },
+      "event": {
+        "additionalProperties": false,
+        "properties": {
+          "urn": {
+            "pattern": "^urn:li:event:\\d+$",
+            "type": "string"
+          }
+        },
+        "required": [
+          "urn"
+        ],
+        "type": "object"
+      },
+      "follower": {
+        "additionalProperties": false,
+        "properties": {
+          "callToAction": {
+            "enum": [
+              "VISIT_ORGANIZATION_COMPANY_PAGE",
+              "VISIT_ORGANIZATION_LIFE_PAGE",
+              "VISIT_ORGANIZATION_JOBS_PAGE",
+              "VISIT_ORGANIZATION_CAREERS_PAGE"
+            ],
+            "type": "string"
+          },
+          "description": {
+            "additionalProperties": false,
+            "properties": {
+              "custom": {
+                "type": "string"
+              },
+              "preApproved": {
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          "headline": {
+            "additionalProperties": false,
+            "properties": {
+              "custom": {
+                "type": "string"
+              },
+              "preApproved": {
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          "logoUrl": {
+            "type": "string"
+          },
+          "organizationName": {
+            "type": "string"
+          },
+          "showMemberProfilePhoto": {
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "headline",
+          "description",
+          "callToAction"
+        ],
+        "type": "object"
+      },
+      "jobs": {
+        "additionalProperties": false,
+        "properties": {
+          "buttonLabel": {
+            "additionalProperties": false,
+            "properties": {
+              "custom": {
+                "type": "string"
+              },
+              "preApproved": {
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          "headline": {
+            "additionalProperties": false,
+            "properties": {
+              "custom": {
+                "type": "string"
+              },
+              "preApproved": {
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          "logoUrl": {
+            "type": "string"
+          },
+          "organizationName": {
+            "type": "string"
+          },
+          "showMemberProfilePhoto": {
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "headline",
+          "buttonLabel"
+        ],
+        "type": "object"
+      },
+      "offsiteDeliveryEnabled": {
+        "type": "boolean"
+      },
+      "optimizationTargetType": {
+        "type": "string"
+      },
+      "spotlight": {
+        "additionalProperties": false,
+        "properties": {
+          "backgroundImageUrl": {
+            "type": "string"
+          },
+          "callToAction": {
+            "type": "string"
+          },
+          "description": {
+            "type": "string"
+          },
+          "headline": {
+            "type": "string"
+          },
+          "landingUrl": {
+            "type": "string"
+          },
+          "logoUrl": {
+            "type": "string"
+          },
+          "organizationName": {
+            "type": "string"
+          },
+          "showMemberProfilePhoto": {
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "headline",
+          "callToAction",
+          "landingUrl"
+        ],
+        "type": "object"
+      },
+      "textAd": {
+        "additionalProperties": false,
+        "properties": {
+          "description": {
+            "maxLength": 75,
+            "type": "string"
+          },
+          "headline": {
+            "maxLength": 25,
+            "type": "string"
+          },
+          "imageUrl": {
+            "type": "string"
+          },
+          "landingUrl": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "headline",
+          "description",
+          "landingUrl"
+        ],
+        "type": "object"
+      },
+      "thoughtLeader": {
+        "additionalProperties": false,
+        "properties": {
+          "postUrn": {
+            "pattern": "^urn:li:(share|ugcPost):\\d+$",
+            "type": "string"
+          }
+        },
+        "required": [
+          "postUrn"
+        ],
+        "type": "object"
+      },
+      "unitCost": {
+        "type": "number"
+      }
+    },
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "bidAmount": {
+        "type": "number"
+      },
+      "bidStrategy": {
+        "enum": [
+          "LOWEST_COST_WITHOUT_CAP",
+          "LOWEST_COST_WITH_BID_CAP",
+          "COST_CAP",
+          "LOWEST_COST_WITH_MIN_ROAS"
+        ],
+        "type": "string"
+      },
+      "customerLifecycle": {
+        "additionalProperties": false,
+        "properties": {
+          "engagedAudienceIds": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "existingCustomerAudienceIds": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "strategy": {
+            "enum": [
+              "all_customers",
+              "new_customers",
+              "new_customers_excluding_engaged"
+            ],
+            "type": "string"
+          }
+        },
+        "required": [
+          "strategy"
+        ],
+        "type": "object"
+      },
+      "dailyMinSpendTarget": {
+        "type": "number"
+      },
+      "lifetimeMinSpendTarget": {
+        "type": "number"
+      },
+      "roasAverageFloor": {
+        "type": "number"
+      }
+    },
+    "type": "object"
+  }
+]

removedInput schema / properties / payload / properties / promotedObject / properties / applicationId / description
```
Removed value: -"App ID. Required for `goal: app_promotion`."
```
removedInput schema / properties / payload / properties / promotedObject / properties / whatsappPhoneNumber / description
```
Removed value: -"Meta only. WhatsApp number on messaging-destination ad sets."
```

changedInput schema / properties / payload / properties / regions / items / anyOf

Previous value: -[
-  {
-    "type": "string"
-  },
-  {
-    "properties": {
-      "key": {
-        "description": "Platform region ID, from /v1/ads/targeting/search results.",
-        "type": "string"
-      }
-    },
-    "required": [
-      "key"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "type": "string"
+  },
+  {
+    "properties": {
+      "key": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "key"
+    ],
+    "type": "object"
+  }
+]

removedInput schema / properties / payload / properties / sitelinks / items / properties / linkUrl / description
```
Removed value: -"Final URL the sitelink navigates to."
```
removedInput schema / properties / payload / properties / smartTargeting / properties / audience / description
```
Removed value: -"TikTok smart_audience_enabled."
```
removedInput schema / properties / payload / properties / smartTargeting / properties / interestsBehaviors / description
```
Removed value: -"TikTok smart_interest_behavior_enabled."
```
removedInput schema / properties / payload / properties / structuredSnippets / items / properties / header / description
```
Removed value: -"One of Google's 13 predefined snippet headers."
```

changedInput schema / properties / payload / properties / targeting / properties / cities / items / anyOf

Previous value: -[
-  {
-    "type": "string"
-  },
-  {
-    "properties": {
-      "distanceUnit": {
-        "description": "Required if radius is set.",
-        "enum": [
-          "mile",
-          "kilometer"
-        ],
-        "type": "string"
-      },
-      "key": {
-        "type": "string"
-      },
-      "name": {
-        "type": "string"
-      },
-      "radius": {
-        "type": "number"
-      }
-    },
-    "required": [
-      "key"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "type": "string"
+  },
+  {
+    "properties": {
+      "distanceUnit": {
+        "enum": [
+          "mile",
+          "kilometer"
+        ],
+        "type": "string"
+      },
+      "key": {
+        "type": "string"
+      },
+      "name": {
+        "type": "string"
+      },
+      "radius": {
+        "type": "number"
+      }
+    },
+    "required": [
+      "key"
+    ],
+    "type": "object"
+  }
+]

removedInput schema / properties / payload / properties / targeting / properties / countries / description
```
Removed value: -"ISO 3166-1 alpha-2 country codes (e.g. ['US'])."
```
addedInput schema / properties / payload / properties / targeting / properties / countryGroups / items / $ref
```
Added value: +"#/definitions/s3"
```

removedInput schema / properties / payload / properties / targeting / properties / countryGroups / items / enum

Removed value: -[
-  "africa",
-  "asia",
-  "europe",
-  "north_america",
-  "south_america",
-  "oceania",
-  "central_america",
-  "caribbean",
-  "eea",
-  "euro_area",
-  "nafta",
-  "mercosur",
-  "afta",
-  "apec",
-  "gcc",
-  "cisfta",
-  "emerging_markets",
-  "itunes_app_store",
-  "android_free_store",
-  "android_paid_store"
-]

removedInput schema / properties / payload / properties / targeting / properties / countryGroups / items / type
```
Removed value: -"string"
```
addedInput schema / properties / payload / properties / targeting / properties / customLocations / items / $ref
```
Added value: +"#/definitions/s2"
```

removedInput schema / properties / payload / properties / targeting / properties / customLocations / items / properties

Removed value: -{
-  "address": {
-    "type": "string"
-  },
-  "distanceUnit": {
-    "enum": [
-      "mile",
-      "kilometer"
-    ],
-    "type": "string"
-  },
-  "latitude": {
-    "maximum": 90,
-    "minimum": -90,
-    "type": "number"
-  },
-  "longitude": {
-    "maximum": 180,
-    "minimum": -180,
-    "type": "number"
-  },
-  "name": {
-    "type": "string"
-  },
-  "radius": {
-    "description": "Positive radius around the point.",
-    "type": "number"
-  }
-}

removedInput schema / properties / payload / properties / targeting / properties / customLocations / items / required
```
Removed value: -[
-  "latitude",
-  "longitude",
-  "radius",
-  "distanceUnit"
-]
```
removedInput schema / properties / payload / properties / targeting / properties / customLocations / items / type
```
Removed value: -"object"
```
removedInput schema / properties / payload / properties / targeting / properties / excludedLocations / properties / cities / items / properties / distanceUnit / description
```
Removed value: -"Required if radius is set."
```
removedInput schema / properties / payload / properties / targeting / properties / excludedLocations / properties / cities / items / properties / radius / description
```
Removed value: -"Radius around the excluded city. Requires distanceUnit."
```
addedInput schema / properties / payload / properties / targeting / properties / excludedLocations / properties / countryGroups / items / $ref
```
Added value: +"#/definitions/s3"
```

removed

Input schema / properties / payload / properties / targeting / properties / excludedLocations / properties / countryGroups / items / enum

Removed value: -[
-  "africa",
-  "asia",
-  "europe",
-  "north_america",
-  "south_america",
-  "oceania",
-  "central_america",
-  "caribbean",
-  "eea",
-  "euro_area",
-  "nafta",
-  "mercosur",
-  "afta",
-  "apec",
-  "gcc",
-  "cisfta",
-  "emerging_markets",
-  "itunes_app_store",
-  "android_free_store",
-  "android_paid_store"
-]

removedInput schema / properties / payload / properties / targeting / properties / excludedLocations / properties / countryGroups / items / type
```
Removed value: -"string"
```
addedInput schema / properties / payload / properties / targeting / properties / excludedLocations / properties / customLocations / items / $ref
```
Added value: +"#/definitions/s2"
```

removed

Input schema / properties / payload / properties / targeting / properties / excludedLocations / properties / customLocations / items / properties

Removed value: -{
-  "address": {
-    "type": "string"
-  },
-  "distanceUnit": {
-    "enum": [
-      "mile",
-      "kilometer"
-    ],
-    "type": "string"
-  },
-  "latitude": {
-    "maximum": 90,
-    "minimum": -90,
-    "type": "number"
-  },
-  "longitude": {
-    "maximum": 180,
-    "minimum": -180,
-    "type": "number"
-  },
-  "name": {
-    "type": "string"
-  },
-  "radius": {
-    "description": "Positive radius around the point.",
-    "type": "number"
-  }
-}

removedInput schema / properties / payload / properties / targeting / properties / excludedLocations / properties / customLocations / items / required
```
Removed value: -[
-  "latitude",
-  "longitude",
-  "radius",
-  "distanceUnit"
-]
```
removedInput schema / properties / payload / properties / targeting / properties / excludedLocations / properties / customLocations / items / type
```
Removed value: -"object"
```
addedInput schema / properties / payload / properties / targeting / properties / excludedLocations / properties / regions / $ref
```
Added value: +"#/definitions/s9"
```

removed

Input schema / properties / payload / properties / targeting / properties / excludedLocations / properties / regions / items

Removed value: -{
-  "properties": {
-    "key": {
-      "type": "string"
-    },
-    "name": {
-      "type": "string"
-    }
-  },
-  "required": [
-    "key"
-  ],
-  "type": "object"
-}

removedInput schema / properties / payload / properties / targeting / properties / excludedLocations / properties / regions / type
```
Removed value: -"array"
```
addedInput schema / properties / payload / properties / targeting / properties / excludedLocations / properties / zips / $ref
```
Added value: +"#/definitions/s9"
```

removed

Input schema / properties / payload / properties / targeting / properties / excludedLocations / properties / zips / items

Removed value: -{
-  "properties": {
-    "key": {
-      "type": "string"
-    },
-    "name": {
-      "type": "string"
-    }
-  },
-  "required": [
-    "key"
-  ],
-  "type": "object"
-}

removedInput schema / properties / payload / properties / targeting / properties / excludedLocations / properties / zips / type
```
Removed value: -"array"
```
addedInput schema / properties / payload / properties / targeting / properties / regions / items / $ref
```
Added value: +"#/definitions/s5"
```

removedInput schema / properties / payload / properties / targeting / properties / regions / items / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "properties": {
-      "key": {
-        "type": "string"
-      },
-      "name": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "key"
-    ],
-    "type": "object"
-  }
-]

addedInput schema / properties / payload / properties / targeting / properties / userDevice / $ref
```
Added value: +"#/definitions/s7"
```
removedInput schema / properties / payload / properties / targeting / properties / userDevice / items
```
Removed value: -{
-  "minLength": 1,
-  "type": "string"
-}
```
removedInput schema / properties / payload / properties / targeting / properties / userDevice / minItems
```
Removed value: -1
```
removedInput schema / properties / payload / properties / targeting / properties / userDevice / type
```
Removed value: -"array"
```
addedInput schema / properties / payload / properties / targeting / properties / userOs / $ref
```
Added value: +"#/definitions/s4"
```
removedInput schema / properties / payload / properties / targeting / properties / userOs / items
```
Removed value: -{
-  "minLength": 1,
-  "type": "string"
-}
```
removedInput schema / properties / payload / properties / targeting / properties / userOs / minItems
```
Removed value: -1
```
removedInput schema / properties / payload / properties / targeting / properties / userOs / type
```
Removed value: -"array"
```
removedInput schema / properties / payload / properties / tracking / properties / pixelId / description
```
Removed value: -"Meta Pixel ID to attach for offsite-conversion measurement."
```
removedInput schema / properties / payload / properties / translations / items / properties / thumbnailUrl / description
```
Removed value: -"Poster frame for this language's video."
```
addedInput schema / properties / payload / properties / userDevice / $ref
```
Added value: +"#/definitions/s7"
```
removedInput schema / properties / payload / properties / userDevice / items
```
Removed value: -{
-  "minLength": 1,
-  "type": "string"
-}
```
removedInput schema / properties / payload / properties / userDevice / minItems
```
Removed value: -1
```
removedInput schema / properties / payload / properties / userDevice / type
```
Removed value: -"array"
```
addedInput schema / properties / payload / properties / userOs / $ref
```
Added value: +"#/definitions/s4"
```
removedInput schema / properties / payload / properties / userOs / items
```
Removed value: -{
-  "minLength": 1,
-  "type": "string"
-}
```
removedInput schema / properties / payload / properties / userOs / minItems
```
Removed value: -1
```
removedInput schema / properties / payload / properties / userOs / type
```
Removed value: -"array"
```
addedInput schema / properties / payload / properties / zips / items / $ref
```
Added value: +"#/definitions/s5"
```

removedInput schema / properties / payload / properties / zips / items / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "properties": {
-      "key": {
-        "type": "string"
-      },
-      "name": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "key"
-    ],
-    "type": "object"
-  }
-]

removedInput schema / properties / platform / description
```
Removed value: -"The campaign platform."
```

Changed4 schema fields changedOct 19, 2026

removedInput schema / properties / payload / properties / carouselCards / items / properties / imageUrl / description
```
Removed value: -"Card image; uploaded to the ad account and referenced by hash."
```

changedInput schema / properties / payload / properties / cities / items / anyOf

Previous value: -[
-  {
-    "description": "The city id alone, e.g. \"1006410\" (same as { key: \"1006410\" }).",
-    "type": "string"
-  },
-  {
-    "properties": {
-      "distance_unit": {
-        "description": "Unit for radius. Required if radius is set.",
-        "enum": [
-          "mile",
-          "kilometer"
-        ],
-        "type": "string"
-      },
-      "key": {
-        "type": "string"
-      },
-      "radius": {
-        "type": "number"
-      }
-    },
-    "required": [
-      "key"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "type": "string"
+  },
+  {
+    "properties": {
+      "distance_unit": {
+        "description": "Unit for radius. Required if radius is set.",
+        "enum": [
+          "mile",
+          "kilometer"
+        ],
+        "type": "string"
+      },
+      "key": {
+        "type": "string"
+      },
+      "radius": {
+        "type": "number"
+      }
+    },
+    "required": [
+      "key"
+    ],
+    "type": "object"
+  }
+]

removedInput schema / properties / payload / properties / placements / properties / devicePlatforms / description
```
Removed value: -"Restrict by device. Omit to deliver on both mobile and desktop."
```

changedInput schema / properties / payload / properties / platformSpecificData / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "audienceExpansionEnabled": {
-        "description": "Enable LinkedIn audience expansion. Defaults to false.",
-        "type": "boolean"
-      },
-      "carousel": {
-        "additionalProperties": false,
-        "properties": {
-          "cards": {
-            "items": {
-              "additionalProperties": false,
-              "properties": {
-                "headline": {
-                  "description": "Card title. Falls back to the ad-level headline.",
-                  "type": "string"
-                },
-                "imageUrl": {
-                  "type": "string"
-                },
-                "landingUrl": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "imageUrl"
-              ],
-              "type": "object"
-            },
-            "maxItems": 10,
-            "minItems": 2,
-            "type": "array"
-          }
-        },
-        "required": [
-          "cards"
-        ],
-        "type": "object"
-      },
-      "connectedTelevisionOnly": {
-        "description": "Restrict delivery to Connected TV inventory.",
-        "type": "boolean"
-      },
-      "conversation": {
-        "additionalProperties": false,
-        "properties": {
-          "body": {
-            "description": "Optional intro body (HTML allowed).",
-            "type": "string"
-          },
-          "firstMessageId": {
-            "type": "string"
-          },
-          "footer": {
-            "description": "Terms shown at the bottom of the message.",
-            "type": "string"
-          },
-          "headline": {
-            "type": "string"
-          },
-          "messages": {
-            "items": {
-              "additionalProperties": false,
-              "properties": {
-                "buttons": {
-                  "items": {
-                    "additionalProperties": false,
-                    "properties": {
-                      "nextMessageId": {
-                        "type": "string"
-                      },
-                      "text": {
-                        "maxLength": 35,
-                        "type": "string"
-                      },
-                      "url": {
-                        "description": "Opens this landing page. Exactly one of nextMessageId or url.",
-                        "type": "string"
-                      }
-                    },
-                    "required": [
-                      "text"
-                    ],
-                    "type": "object"
-                  },
-                  "maxItems": 5,
-                  "minItems": 1,
-                  "type": "array"
-                },
-                "id": {
-                  "type": "string"
-                },
-                "text": {
-                  "maxLength": 500,
-                  "type": "string"
-                }
-              },
-              "required": [
-                "id",
-                "text"
-              ],
-              "type": "object"
-            },
-            "maxItems": 25,
-            "minItems": 1,
-            "type": "array"
-          },
-          "sender": {
-            "type": "string"
-          },
-          "subject": {
-            "description": "InMail subject shown in the inbox.",
-            "type": "string"
-          }
-        },
-        "required": [
-          "subject",
-          "firstMessageId",
-          "messages"
-        ],
-        "type": "object"
-      },
-      "costType": {
-        "enum": [
-          "CPM",
-          "CPC",
-          "CPV"
-        ],
-        "type": "string"
-      },
-      "creativeSelection": {
-        "enum": [
-          "OPTIMIZED",
-          "ROUND_ROBIN"
-        ],
-        "type": "string"
-      },
-      "document": {
-        "additionalProperties": false,
-        "properties": {
-          "title": {
-            "description": "Document title.",
-            "type": "string"
-          },
-          "url": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "url",
-          "title"
-        ],
-        "type": "object"
-      },
-      "event": {
-        "additionalProperties": false,
-        "properties": {
-          "urn": {
-            "description": "LinkedIn Event URN, urn:li:event:N.",
-            "pattern": "^urn:li:event:\\d+$",
-            "type": "string"
-          }
-        },
-        "required": [
-          "urn"
-        ],
-        "type": "object"
-      },
-      "follower": {
-        "additionalProperties": false,
-        "properties": {
-          "callToAction": {
-            "enum": [
-              "VISIT_ORGANIZATION_COMPANY_PAGE",
-              "VISIT_ORGANIZATION_LIFE_PAGE",
-              "VISIT_ORGANIZATION_JOBS_PAGE",
-              "VISIT_ORGANIZATION_CAREERS_PAGE"
-            ],
-            "type": "string"
-          },
-          "description": {
-            "additionalProperties": false,
-            "properties": {
-              "custom": {
-                "description": "Free text, reviewed by LinkedIn.",
-                "type": "string"
-              },
-              "preApproved": {
-                "type": "string"
-              }
-            },
-            "type": "object"
-          },
-          "headline": {
-            "additionalProperties": false,
-            "properties": {
-              "custom": {
-                "description": "Free text, reviewed by LinkedIn.",
-                "type": "string"
-              },
-              "preApproved": {
-                "type": "string"
-              }
-            },
-            "type": "object"
-          },
-          "logoUrl": {
-            "type": "string"
-          },
-          "organizationName": {
-            "type": "string"
-          },
-          "showMemberProfilePhoto": {
-            "description": "Defaults to true.",
-            "type": "boolean"
-          }
-        },
-        "required": [
-          "headline",
-          "description",
-          "callToAction"
-        ],
-        "type": "object"
-      },
-      "jobs": {
-        "additionalProperties": false,
-        "properties": {
-          "buttonLabel": {
-            "additionalProperties": false,
-            "properties": {
-              "custom": {
-                "description": "Free text, reviewed by LinkedIn.",
-                "type": "string"
-              },
-              "preApproved": {
-                "type": "string"
-              }
-            },
-            "type": "object"
-          },
-          "headline": {
-            "additionalProperties": false,
-            "properties": {
-              "custom": {
-                "description": "Free text, reviewed by LinkedIn.",
-                "type": "string"
-              },
-              "preApproved": {
-                "type": "string"
-              }
-            },
-            "type": "object"
-          },
-          "logoUrl": {
-            "type": "string"
-          },
-          "organizationName": {
-            "type": "string"
-          },
-          "showMemberProfilePhoto": {
-            "description": "Defaults to true.",
-            "type": "boolean"
-          }
-        },
-        "required": [
-          "headline",
-          "buttonLabel"
-        ],
-        "type": "object"
-      },
-      "offsiteDeliveryEnabled": {
-        "description": "Deliver on the LinkedIn Audience Network. Defaults to false.",
-        "type": "boolean"
-      },
-      "optimizationTargetType": {
-        "type": "string"
-      },
-      "spotlight": {
-        "additionalProperties": false,
-        "properties": {
-          "backgroundImageUrl": {
-            "type": "string"
-          },
-          "callToAction": {
-            "description": "Button label text.",
-            "type": "string"
-          },
-          "description": {
-            "description": "Mutually exclusive with backgroundImageUrl.",
-            "type": "string"
-          },
-          "headline": {
-            "type": "string"
-          },
-          "landingUrl": {
-            "type": "string"
-          },
-          "logoUrl": {
-            "type": "string"
-          },
-          "organizationName": {
-            "type": "string"
-          },
-          "showMemberProfilePhoto": {
-            "description": "Defaults to true.",
-            "type": "boolean"
-          }
-        },
-        "required": [
-          "headline",
-          "callToAction",
-          "landingUrl"
-        ],
-        "type": "object"
-      },
-      "textAd": {
-        "additionalProperties": false,
-        "properties": {
-          "description": {
-            "maxLength": 75,
-            "type": "string"
-          },
-          "headline": {
-            "maxLength": 25,
-            "type": "string"
-          },
-          "imageUrl": {
-            "description": "Optional 100x100 image.",
-            "type": "string"
-          },
-          "landingUrl": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "headline",
-          "description",
-          "landingUrl"
-        ],
-        "type": "object"
-      },
-      "thoughtLeader": {
-        "additionalProperties": false,
-        "properties": {
-          "postUrn": {
-            "pattern": "^urn:li:(share|ugcPost):\\d+$",
-            "type": "string"
-          }
-        },
-        "required": [
-          "postUrn"
-        ],
-        "type": "object"
-      },
-      "unitCost": {
-        "type": "number"
-      }
-    },
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "bidAmount": {
-        "type": "number"
-      },
-      "bidStrategy": {
-        "enum": [
-          "LOWEST_COST_WITHOUT_CAP",
-          "LOWEST_COST_WITH_BID_CAP",
-          "COST_CAP",
-          "LOWEST_COST_WITH_MIN_ROAS"
-        ],
-        "type": "string"
-      },
-      "customerLifecycle": {
-        "additionalProperties": false,
-        "properties": {
-          "engagedAudienceIds": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "existingCustomerAudienceIds": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "strategy": {
-            "enum": [
-              "all_customers",
-              "new_customers",
-              "new_customers_excluding_engaged"
-            ],
-            "type": "string"
-          }
-        },
-        "required": [
-          "strategy"
-        ],
-        "type": "object"
-      },
-      "dailyMinSpendTarget": {
-        "type": "number"
-      },
-      "lifetimeMinSpendTarget": {
-        "type": "number"
-      },
-      "roasAverageFloor": {
-        "type": "number"
-      }
-    },
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "audienceExpansionEnabled": {
+        "description": "Enable LinkedIn audience expansion. Defaults to false.",
+        "type": "boolean"
+      },
+      "carousel": {
+        "additionalProperties": false,
+        "properties": {
+          "cards": {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "headline": {
+                  "description": "Card title. Falls back to the ad-level headline.",
+                  "type": "string"
+                },
+                "imageUrl": {
+                  "type": "string"
+                },
+                "landingUrl": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "imageUrl"
+              ],
+              "type": "object"
+            },
+            "maxItems": 10,
+            "minItems": 2,
+            "type": "array"
+          }
+        },
+        "required": [
+          "cards"
+        ],
+        "type": "object"
+      },
+      "connectedTelevisionOnly": {
+        "description": "Restrict delivery to Connected TV inventory.",
+        "type": "boolean"
+      },
+      "conversation": {
+        "additionalProperties": false,
+        "properties": {
+          "body": {
+            "description": "Optional intro body (HTML allowed).",
+            "type": "string"
+          },
+          "firstMessageId": {
+            "type": "string"
+          },
+          "footer": {
+            "description": "Terms shown at the bottom of the message.",
+            "type": "string"
+          },
+          "headline": {
+            "type": "string"
+          },
+          "messages": {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "buttons": {
+                  "items": {
+                    "additionalProperties": false,
+                    "properties": {
+                      "nextMessageId": {
+                        "type": "string"
+                      },
+                      "text": {
+                        "maxLength": 35,
+                        "type": "string"
+                      },
+                      "url": {
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "text"
+                    ],
+                    "type": "object"
+                  },
+                  "maxItems": 5,
+                  "minItems": 1,
+                  "type": "array"
+                },
+                "id": {
+                  "type": "string"
+                },
+                "text": {
+                  "maxLength": 500,
+                  "type": "string"
+                }
+              },
+              "required": [
+                "id",
+                "text"
+              ],
+              "type": "object"
+            },
+            "maxItems": 25,
+            "minItems": 1,
+            "type": "array"
+          },
+          "sender": {
+            "type": "string"
+          },
+          "subject": {
+            "description": "InMail subject shown in the inbox.",
+            "type": "string"
+          }
+        },
+        "required": [
+          "subject",
+          "firstMessageId",
+          "messages"
+        ],
+        "type": "object"
+      },
+      "costType": {
+        "enum": [
+          "CPM",
+          "CPC",
+          "CPV"
+        ],
+        "type": "string"
+      },
+      "creativeSelection": {
+        "enum": [
+          "OPTIMIZED",
+          "ROUND_ROBIN"
+        ],
+        "type": "string"
+      },
+      "document": {
+        "additionalProperties": false,
+        "properties": {
+          "title": {
+            "description": "Document title.",
+            "type": "string"
+          },
+          "url": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "url",
+          "title"
+        ],
+        "type": "object"
+      },
+      "event": {
+        "additionalProperties": false,
+        "properties": {
+          "urn": {
+            "description": "LinkedIn Event URN, urn:li:event:N.",
+            "pattern": "^urn:li:event:\\d+$",
+            "type": "string"
+          }
+        },
+        "required": [
+          "urn"
+        ],
+        "type": "object"
+      },
+      "follower": {
+        "additionalProperties": false,
+        "properties": {
+          "callToAction": {
+            "enum": [
+              "VISIT_ORGANIZATION_COMPANY_PAGE",
+              "VISIT_ORGANIZATION_LIFE_PAGE",
+              "VISIT_ORGANIZATION_JOBS_PAGE",
+              "VISIT_ORGANIZATION_CAREERS_PAGE"
+            ],
+            "type": "string"
+          },
+          "description": {
+            "additionalProperties": false,
+            "properties": {
+              "custom": {
+                "description": "Free text, reviewed by LinkedIn.",
+                "type": "string"
+              },
+              "preApproved": {
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          "headline": {
+            "additionalProperties": false,
+            "properties": {
+              "custom": {
+                "description": "Free text, reviewed by LinkedIn.",
+                "type": "string"
+              },
+              "preApproved": {
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          "logoUrl": {
+            "type": "string"
+          },
+          "organizationName": {
+            "type": "string"
+          },
+          "showMemberProfilePhoto": {
+            "description": "Defaults to true.",
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "headline",
+          "description",
+          "callToAction"
+        ],
+        "type": "object"
+      },
+      "jobs": {
+        "additionalProperties": false,
+        "properties": {
+          "buttonLabel": {
+            "additionalProperties": false,
+            "properties": {
+              "custom": {
+                "description": "Free text, reviewed by LinkedIn.",
+                "type": "string"
+              },
+              "preApproved": {
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          "headline": {
+            "additionalProperties": false,
+            "properties": {
+              "custom": {
+                "description": "Free text, reviewed by LinkedIn.",
+                "type": "string"
+              },
+              "preApproved": {
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          "logoUrl": {
+            "type": "string"
+          },
+          "organizationName": {
+            "type": "string"
+          },
+          "showMemberProfilePhoto": {
+            "description": "Defaults to true.",
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "headline",
+          "buttonLabel"
+        ],
+        "type": "object"
+      },
+      "offsiteDeliveryEnabled": {
+        "description": "Deliver on the LinkedIn Audience Network. Defaults to false.",
+        "type": "boolean"
+      },
+      "optimizationTargetType": {
+        "type": "string"
+      },
+      "spotlight": {
+        "additionalProperties": false,
+        "properties": {
+          "backgroundImageUrl": {
+            "type": "string"
+          },
+          "callToAction": {
+            "description": "Button label text.",
+            "type": "string"
+          },
+          "description": {
+            "description": "Mutually exclusive with backgroundImageUrl.",
+            "type": "string"
+          },
+          "headline": {
+            "type": "string"
+          },
+          "landingUrl": {
+            "type": "string"
+          },
+          "logoUrl": {
+            "type": "string"
+          },
+          "organizationName": {
+            "type": "string"
+          },
+          "showMemberProfilePhoto": {
+            "description": "Defaults to true.",
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "headline",
+          "callToAction",
+          "landingUrl"
+        ],
+        "type": "object"
+      },
+      "textAd": {
+        "additionalProperties": false,
+        "properties": {
+          "description": {
+            "maxLength": 75,
+            "type": "string"
+          },
+          "headline": {
+            "maxLength": 25,
+            "type": "string"
+          },
+          "imageUrl": {
+            "description": "Optional 100x100 image.",
+            "type": "string"
+          },
+          "landingUrl": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "headline",
+          "description",
+          "landingUrl"
+        ],
+        "type": "object"
+      },
+      "thoughtLeader": {
+        "additionalProperties": false,
+        "properties": {
+          "postUrn": {
+            "pattern": "^urn:li:(share|ugcPost):\\d+$",
+            "type": "string"
+          }
+        },
+        "required": [
+          "postUrn"
+        ],
+        "type": "object"
+      },
+      "unitCost": {
+        "type": "number"
+      }
+    },
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "bidAmount": {
+        "type": "number"
+      },
+      "bidStrategy": {
+        "enum": [
+          "LOWEST_COST_WITHOUT_CAP",
+          "LOWEST_COST_WITH_BID_CAP",
+          "COST_CAP",
+          "LOWEST_COST_WITH_MIN_ROAS"
+        ],
+        "type": "string"
+      },
+      "customerLifecycle": {
+        "additionalProperties": false,
+        "properties": {
+          "engagedAudienceIds": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "existingCustomerAudienceIds": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "strategy": {
+            "enum": [
+              "all_customers",
+              "new_customers",
+              "new_customers_excluding_engaged"
+            ],
+            "type": "string"
+          }
+        },
+        "required": [
+          "strategy"
+        ],
+        "type": "object"
+      },
+      "dailyMinSpendTarget": {
+        "type": "number"
+      },
+      "lifetimeMinSpendTarget": {
+        "type": "number"
+      },
+      "roasAverageFloor": {
+        "type": "number"
+      }
+    },
+    "type": "object"
+  }
+]

First observedOct 12, 2026

TDQS

A4.1/5.0

Behavior5/5

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

Beyond the annotations, the description discloses critical behavioral traits for a destructive, non-idempotent purchase: quote before confirmation, owner approval of spending, requestId reuse for recovery, no automatic repeats, and status caveats around platform review and live delivery. This directly reduces the risk of harmful invocation.

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

Conciseness5/5

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

The description is appropriately dense for a destructive financial operation. It is front-loaded with the creation action and then the critical quote, approval, recovery, and status rules, with every sentence contributing to safe invocation.

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

Completeness4/5

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

For a highly complex, destructive, open-world creation tool with no output schema, the description covers the safety-critical workflow and gives some sense of returned preview/status. It is not fully complete because it does not explain platform-specific payload requirements or comprehensively describe returned data.

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 60%, and the description adds meaningful context around confirm:true, requestId reuse, and approved preview values. However, it does not explain most of the very large payload schema or distinguish accountId from adAccountId, so the schema still carries most parameter semantics.

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?

The description gives a specific verb and resource: create a standalone advertisement from creative, targeting, and budget in the selected ad account. This distinguishes it from generic ad-platform tools, but it does not explicitly name or differentiate it from nearby siblings such as create_ad_creative, create_ad_campaign, create_ad_set, create_call_ad, or create_messaging_ad.

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?

The description gives unusually clear workflow guidance: quote first without confirm:true, show the spending preview, obtain owner approval, confirm with the same requestId, and use operation_status after uncertain results. It does not explicitly state when to choose this tool over the many sibling ad-creation tools, so it falls short of full alternative routing.

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

All Soclo 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?