Skip to main content
Glama

Soclo

by app.soclo
OverviewDiscussionsAdmin

Create custom audience

soclo_ads_create_ad_audience
Destructive

Soclo Ads: Create custom audience. Spending/deletion: preview, then owner-approved confirm:true with the same requestId. Claim live only when status is active. Fields: soclo://tools/soclo_ads_create_ad_audience.

Input Schema

NameRequiredDescriptionDefault
confirmNoTrue only after owner approval of spending/deletion preview.
payloadYes
platformNo
accountIdYes
requestIdNoReuse this request ID for confirmation and outcome recovery.
parametersNo
adAccountIdNoAdvertiser/ad account selected from your Soclo connection.
expectedCurrencyNoApproved preview currency, e.g. GBP.
expectedBudgetTypeNoApproved preview budget type: daily or lifetime.
expectedBudgetAmountNoApproved preview amount; changes require a new preview.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed4 schema fields changed
    • addedInput schema / definitions
      Added value: +{
+  "s1": {
+    "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"
+  },
+  "s2": {
+    "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"
+  },
+  "s3": {
+    "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."
    • changedInput schema / properties / payload / anyOf
      Previous value: -[
-  {
-    "properties": {
-      "adIds": {
-        "description": "pinterest_engagement: people who engaged with these ads.",
-        "items": {
-          "pattern": "^\\d+$",
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "campaignIds": {
-        "items": {
-          "pattern": "^\\d+$",
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "companies": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "domain": {
-              "maxLength": 100,
-              "type": "string"
-            },
-            "linkedinPageUrl": {
-              "type": "string"
-            },
-            "name": {
-              "maxLength": 255,
-              "type": "string"
-            },
-            "website": {
-              "maxLength": 100,
-              "type": "string"
-            }
-          },
-          "type": "object"
-        },
-        "maxItems": 300000,
-        "minItems": 1,
-        "type": "array"
-      },
-      "country": {
-        "description": "2-letter code, required for lookalike audiences",
-        "type": "string"
-      },
-      "customerFileSource": {
-        "type": "string"
-      },
-      "description": {
-        "type": "string"
-      },
-      "engagementDomains": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "engagementSource": {
-        "enum": [
-          "page",
-          "instagram",
-          "video"
-        ],
-        "type": "string"
-      },
-      "engagementSources": {
-        "items": {
-          "type": "string"
-        },
-        "maxItems": 50,
-        "minItems": 1,
-        "type": "array"
-      },
-      "engagementType": {
-        "description": "pinterest_engagement: limit to one engagement action.",
-        "enum": [
-          "click",
-          "save",
-          "closeup",
-          "comment",
-          "like"
-        ],
-        "type": "string"
-      },
-      "engagerType": {
-        "enum": [
-          1,
-          2
-        ],
-        "type": "number"
-      },
-      "event": {
-        "maxLength": 100,
-        "type": "string"
-      },
-      "identityAuthorizedBcId": {
-        "description": "tiktok_engagement: required when identityType is BC_AUTH_TT.",
-        "type": "string"
-      },
-      "identityId": {
-        "type": "string"
-      },
-      "identityType": {
-        "description": "tiktok_engagement: type of `identityId`.",
-        "enum": [
-          "TT_USER",
-          "BC_AUTH_TT"
-        ],
-        "type": "string"
-      },
-      "lookbackDays": {
-        "description": "Required for engagement audiences. Rolling window.",
-        "enum": [
-          30,
-          60,
-          90,
-          180,
-          365
-        ],
-        "type": "number"
-      },
-      "matchRules": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "matchType": {
-              "enum": [
-                "EXACT",
-                "STARTS_WITH",
-                "CONTAINS",
-                "ENDS_WITH"
-              ],
-              "type": "string"
-            },
-            "matchValue": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "matchType",
-            "matchValue"
-          ],
-          "type": "object"
-        },
-        "maxItems": 50,
-        "minItems": 1,
-        "type": "array"
-      },
-      "name": {
-        "maxLength": 255,
-        "type": "string"
-      },
-      "pinIds": {
-        "items": {
-          "pattern": "^\\d+$",
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "pixelId": {
-        "type": "string"
-      },
-      "ratio": {
-        "maximum": 0.2,
-        "minimum": 0.01,
-        "type": "number"
-      },
-      "retentionDays": {
-        "maximum": 540,
-        "minimum": 1,
-        "type": "integer"
-      },
-      "rule": {
-        "type": "object"
-      },
-      "size": {
-        "enum": [
-          "narrow",
-          "balanced",
-          "broad"
-        ],
-        "type": "string"
-      },
-      "source": {
-        "description": "Required for tiktok_engagement: what people engaged with.",
-        "enum": [
-          "ads",
-          "organic_video",
-          "live_video",
-          "business_account"
-        ],
-        "type": "string"
-      },
-      "sourceAudienceId": {
-        "description": "Required for lookalike audiences",
-        "type": "string"
-      },
-      "sourceId": {
-        "type": "string"
-      },
-      "sourceIds": {
-        "items": {
-          "type": "string"
-        },
-        "maxItems": 50,
-        "minItems": 1,
-        "type": "array"
-      },
-      "sourceType": {
-        "enum": [
-          "VIDEO_ADS",
-          "LEAD_GEN_FORMS",
-          "ORGANIZATION_PAGES",
-          "EVENT_PAGES",
-          "SINGLE_IMAGE_ADS"
-        ],
-        "type": "string"
-      },
-      "trigger": {
-        "type": "string"
-      },
-      "type": {
-        "enum": [
-          "customer_list",
-          "company_list",
-          "engagement",
-          "meta_engagement",
-          "tiktok_engagement",
-          "pinterest_engagement",
-          "website",
-          "website_retargeting",
-          "lookalike"
-        ],
-        "type": "string"
-      },
-      "urlContains": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "name",
-      "type"
-    ],
-    "type": "object"
-  },
-  {
-    "properties": {
-      "description": {
-        "type": "string"
-      },
-      "name": {
-        "maxLength": 255,
-        "type": "string"
-      },
-      "spec": {
-        "description": "The targeting spec to store.",
-        "properties": {
-          "ageMax": {
-            "maximum": 100,
-            "minimum": 13,
-            "type": "integer"
-          },
-          "ageMin": {
-            "maximum": 100,
-            "minimum": 13,
-            "type": "integer"
-          },
-          "audienceExclude": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "audienceInclude": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "behaviors": {
-            "items": {
-              "properties": {
-                "id": {
-                  "type": "string"
-                },
-                "name": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "id"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "cities": {
-            "items": {
-              "anyOf": [
-                {
-                  "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"
-                }
-              ]
-            },
-            "type": "array"
-          },
-          "companySizes": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "countries": {
-            "description": "ISO 3166-1 alpha-2 country codes (e.g. ['US']).",
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "countryGroups": {
-            "items": {
-              "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"
-            },
-            "type": "array"
-          },
-          "customLocations": {
-            "items": {
-              "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": {
-                  "description": "Positive radius around the point.",
-                  "type": "number"
-                }
-              },
-              "required": [
-                "latitude",
-                "longitude",
-                "radius",
-                "distanceUnit"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "excludedLocations": {
-            "properties": {
-              "cities": {
-                "items": {
-                  "properties": {
-                    "distanceUnit": {
-                      "description": "Required if radius is set.",
-                      "enum": [
-                        "mile",
-                        "kilometer"
-                      ],
-                      "type": "string"
-                    },
-                    "key": {
-                      "type": "string"
-                    },
-                    "radius": {
-                      "description": "Radius around the excluded city. Requires distanceUnit.",
-                      "type": "number"
-                    }
-                  },
-                  "required": [
-                    "key"
-                  ],
-                  "type": "object"
-                },
-                "type": "array"
-              },
-              "countries": {
-                "items": {
-                  "type": "string"
-                },
-                "type": "array"
-              },
-              "countryGroups": {
-                "items": {
-                  "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"
-                },
-                "type": "array"
-              },
-              "customLocations": {
-                "items": {
-                  "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": {
-                      "description": "Positive radius around the point.",
-                      "type": "number"
-                    }
-                  },
-                  "required": [
-                    "latitude",
-                    "longitude",
-                    "radius",
-                    "distanceUnit"
-                  ],
-                  "type": "object"
-                },
-                "type": "array"
-              },
-              "neighborhoods": {
-                "items": {
-                  "properties": {
-                    "key": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "key"
-                  ],
-                  "type": "object"
-                },
-                "type": "array"
-              },
-              "places": {
-                "items": {
-                  "properties": {
-                    "key": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "key"
-                  ],
-                  "type": "object"
-                },
-                "type": "array"
-              },
-              "regions": {
-                "items": {
-                  "properties": {
-                    "key": {
-                      "type": "string"
-                    },
-                    "name": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "key"
-                  ],
-                  "type": "object"
-                },
-                "type": "array"
-              },
-              "zips": {
-                "items": {
-                  "properties": {
-                    "key": {
-                      "type": "string"
-                    },
-                    "name": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "key"
-                  ],
-                  "type": "object"
-                },
-                "type": "array"
-              }
-            },
-            "type": "object"
-          },
-          "gender": {
-            "enum": [
-              "all",
-              "male",
-              "female"
-            ],
-            "type": "string"
-          },
-          "incomeTier": {
-            "enum": [
-              "top_5",
-              "top_10",
-              "top_10_25",
-              "top_25_50"
-            ],
-            "type": "string"
-          },
-          "industries": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "interests": {
-            "items": {
-              "properties": {
-                "id": {
-                  "type": "string"
-                },
-                "name": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "id"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "jobFunctions": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "languages": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "metros": {
-            "items": {
-              "properties": {
-                "key": {
-                  "type": "string"
-                },
-                "name": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "key"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "regions": {
-            "items": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "properties": {
-                    "key": {
-                      "type": "string"
-                    },
-                    "name": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "key"
-                  ],
-                  "type": "object"
-                }
-              ]
-            },
-            "type": "array"
-          },
-          "seniorities": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "userDevice": {
-            "items": {
-              "minLength": 1,
-              "type": "string"
-            },
-            "minItems": 1,
-            "type": "array"
-          },
-          "userOs": {
-            "items": {
-              "minLength": 1,
-              "type": "string"
-            },
-            "minItems": 1,
-            "type": "array"
-          },
-          "workEmployers": {
-            "items": {
-              "properties": {
-                "id": {
-                  "type": "string"
-                },
-                "name": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "id"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "workIndustries": {
-            "items": {
-              "properties": {
-                "id": {
-                  "type": "string"
-                },
-                "name": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "id"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "workPositions": {
-            "items": {
-              "properties": {
-                "id": {
-                  "type": "string"
-                },
-                "name": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "id"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "zips": {
-            "items": {
-              "properties": {
-                "key": {
-                  "type": "string"
-                },
-                "name": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "key"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          }
-        },
-        "type": "object"
-      },
-      "type": {
-        "const": "saved_targeting",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "name",
-      "spec"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "properties": {
+      "adIds": {
+        "items": {
+          "pattern": "^\\d+$",
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "campaignIds": {
+        "items": {
+          "pattern": "^\\d+$",
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "companies": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "domain": {
+              "maxLength": 100,
+              "type": "string"
+            },
+            "linkedinPageUrl": {
+              "type": "string"
+            },
+            "name": {
+              "maxLength": 255,
+              "type": "string"
+            },
+            "website": {
+              "maxLength": 100,
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "maxItems": 300000,
+        "minItems": 1,
+        "type": "array"
+      },
+      "country": {
+        "type": "string"
+      },
+      "customerFileSource": {
+        "type": "string"
+      },
+      "description": {
+        "type": "string"
+      },
+      "engagementDomains": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "engagementSource": {
+        "enum": [
+          "page",
+          "instagram",
+          "video"
+        ],
+        "type": "string"
+      },
+      "engagementSources": {
+        "items": {
+          "type": "string"
+        },
+        "maxItems": 50,
+        "minItems": 1,
+        "type": "array"
+      },
+      "engagementType": {
+        "enum": [
+          "click",
+          "save",
+          "closeup",
+          "comment",
+          "like"
+        ],
+        "type": "string"
+      },
+      "engagerType": {
+        "enum": [
+          1,
+          2
+        ],
+        "type": "number"
+      },
+      "event": {
+        "maxLength": 100,
+        "type": "string"
+      },
+      "identityAuthorizedBcId": {
+        "type": "string"
+      },
+      "identityId": {
+        "type": "string"
+      },
+      "identityType": {
+        "enum": [
+          "TT_USER",
+          "BC_AUTH_TT"
+        ],
+        "type": "string"
+      },
+      "lookbackDays": {
+        "enum": [
+          30,
+          60,
+          90,
+          180,
+          365
+        ],
+        "type": "number"
+      },
+      "matchRules": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "matchType": {
+              "enum": [
+                "EXACT",
+                "STARTS_WITH",
+                "CONTAINS",
+                "ENDS_WITH"
+              ],
+              "type": "string"
+            },
+            "matchValue": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "matchType",
+            "matchValue"
+          ],
+          "type": "object"
+        },
+        "maxItems": 50,
+        "minItems": 1,
+        "type": "array"
+      },
+      "name": {
+        "maxLength": 255,
+        "type": "string"
+      },
+      "pinIds": {
+        "items": {
+          "pattern": "^\\d+$",
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "pixelId": {
+        "type": "string"
+      },
+      "ratio": {
+        "maximum": 0.2,
+        "minimum": 0.01,
+        "type": "number"
+      },
+      "retentionDays": {
+        "maximum": 540,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "rule": {
+        "type": "object"
+      },
+      "size": {
+        "enum": [
+          "narrow",
+          "balanced",
+          "broad"
+        ],
+        "type": "string"
+      },
+      "source": {
+        "enum": [
+          "ads",
+          "organic_video",
+          "live_video",
+          "business_account"
+        ],
+        "type": "string"
+      },
+      "sourceAudienceId": {
+        "type": "string"
+      },
+      "sourceId": {
+        "type": "string"
+      },
+      "sourceIds": {
+        "items": {
+          "type": "string"
+        },
+        "maxItems": 50,
+        "minItems": 1,
+        "type": "array"
+      },
+      "sourceType": {
+        "enum": [
+          "VIDEO_ADS",
+          "LEAD_GEN_FORMS",
+          "ORGANIZATION_PAGES",
+          "EVENT_PAGES",
+          "SINGLE_IMAGE_ADS"
+        ],
+        "type": "string"
+      },
+      "trigger": {
+        "type": "string"
+      },
+      "type": {
+        "enum": [
+          "customer_list",
+          "company_list",
+          "engagement",
+          "meta_engagement",
+          "tiktok_engagement",
+          "pinterest_engagement",
+          "website",
+          "website_retargeting",
+          "lookalike"
+        ],
+        "type": "string"
+      },
+      "urlContains": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "name",
+      "type"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "description": {
+        "type": "string"
+      },
+      "name": {
+        "maxLength": 255,
+        "type": "string"
+      },
+      "spec": {
+        "properties": {
+          "ageMax": {
+            "maximum": 100,
+            "minimum": 13,
+            "type": "integer"
+          },
+          "ageMin": {
+            "maximum": 100,
+            "minimum": 13,
+            "type": "integer"
+          },
+          "audienceExclude": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "audienceInclude": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "behaviors": {
+            "items": {
+              "properties": {
+                "id": {
+                  "type": "string"
+                },
+                "name": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "id"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "cities": {
+            "items": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "properties": {
+                    "distanceUnit": {
+                      "enum": [
+                        "mile",
+                        "kilometer"
+                      ],
+                      "type": "string"
+                    },
+                    "key": {
+                      "type": "string"
+                    },
+                    "name": {
+                      "type": "string"
+                    },
+                    "radius": {
+                      "type": "number"
+                    }
+                  },
+                  "required": [
+                    "key"
+                  ],
+                  "type": "object"
+                }
+              ]
+            },
+            "type": "array"
+          },
+          "companySizes": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "countries": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "countryGroups": {
+            "items": {
+              "$ref": "#/definitions/s2"
+            },
+            "type": "array"
+          },
+          "customLocations": {
+            "items": {
+              "$ref": "#/definitions/s1"
+            },
+            "type": "array"
+          },
+          "excludedLocations": {
+            "properties": {
+              "cities": {
+                "items": {
+                  "properties": {
+                    "distanceUnit": {
+                      "enum": [
+                        "mile",
+                        "kilometer"
+                      ],
+                      "type": "string"
+                    },
+                    "key": {
+                      "type": "string"
+                    },
+                    "radius": {
+                      "type": "number"
+                    }
+                  },
+                  "required": [
+                    "key"
+                  ],
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "countries": {
+                "items": {
+                  "type": "string"
+                },
+                "type": "array"
+              },
+              "countryGroups": {
+                "items": {
+                  "$ref": "#/definitions/s2"
+                },
+                "type": "array"
+              },
+              "customLocations": {
+                "items": {
+                  "$ref": "#/definitions/s1"
+                },
+                "type": "array"
+              },
+              "neighborhoods": {
+                "items": {
+                  "properties": {
+                    "key": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "key"
+                  ],
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "places": {
+                "items": {
+                  "properties": {
+                    "key": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "key"
+                  ],
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "regions": {
+                "$ref": "#/definitions/s3"
+              },
+              "zips": {
+                "$ref": "#/definitions/s3"
+              }
+            },
+            "type": "object"
+          },
+          "gender": {
+            "enum": [
+              "all",
+              "male",
+              "female"
+            ],
+            "type": "string"
+          },
+          "incomeTier": {
+            "enum": [
+              "top_5",
+              "top_10",
+              "top_10_25",
+              "top_25_50"
+            ],
+            "type": "string"
+          },
+          "industries": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "interests": {
+            "items": {
+              "properties": {
+                "id": {
+                  "type": "string"
+                },
+                "name": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "id"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "jobFunctions": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "languages": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "metros": {
+            "items": {
+              "properties": {
+                "key": {
+                  "type": "string"
+                },
+                "name": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "key"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "regions": {
+            "items": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "properties": {
+                    "key": {
+                      "type": "string"
+                    },
+                    "name": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "key"
+                  ],
+                  "type": "object"
+                }
+              ]
+            },
+            "type": "array"
+          },
+          "seniorities": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "userDevice": {
+            "items": {
+              "minLength": 1,
+              "type": "string"
+            },
+            "minItems": 1,
+            "type": "array"
+          },
+          "userOs": {
+            "items": {
+              "minLength": 1,
+              "type": "string"
+            },
+            "minItems": 1,
+            "type": "array"
+          },
+          "workEmployers": {
+            "items": {
+              "properties": {
+                "id": {
+                  "type": "string"
+                },
+                "name": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "id"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "workIndustries": {
+            "items": {
+              "properties": {
+                "id": {
+                  "type": "string"
+                },
+                "name": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "id"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "workPositions": {
+            "items": {
+              "properties": {
+                "id": {
+                  "type": "string"
+                },
+                "name": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "id"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "zips": {
+            "items": {
+              "properties": {
+                "key": {
+                  "type": "string"
+                },
+                "name": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "key"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          }
+        },
+        "type": "object"
+      },
+      "type": {
+        "const": "saved_targeting",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "name",
+      "spec"
+    ],
+    "type": "object"
+  }
+]
    • removedInput schema / properties / platform / description
      Removed value: -"The campaign platform."
  2. Changed1 schema field changed
    • changedInput schema / properties / payload / anyOf
      Previous value: -[
-  {
-    "properties": {
-      "adIds": {
-        "description": "pinterest_engagement: people who engaged with these ads.",
-        "items": {
-          "pattern": "^\\d+$",
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "campaignIds": {
-        "items": {
-          "pattern": "^\\d+$",
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "companies": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "domain": {
-              "maxLength": 100,
-              "type": "string"
-            },
-            "linkedinPageUrl": {
-              "type": "string"
-            },
-            "name": {
-              "maxLength": 255,
-              "type": "string"
-            },
-            "website": {
-              "maxLength": 100,
-              "type": "string"
-            }
-          },
-          "type": "object"
-        },
-        "maxItems": 300000,
-        "minItems": 1,
-        "type": "array"
-      },
-      "country": {
-        "description": "2-letter code, required for lookalike audiences",
-        "type": "string"
-      },
-      "customerFileSource": {
-        "description": "Data source declaration for GDPR compliance (customer_list only)",
-        "type": "string"
-      },
-      "description": {
-        "type": "string"
-      },
-      "engagementDomains": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "engagementSource": {
-        "enum": [
-          "page",
-          "instagram",
-          "video"
-        ],
-        "type": "string"
-      },
-      "engagementSources": {
-        "items": {
-          "type": "string"
-        },
-        "maxItems": 50,
-        "minItems": 1,
-        "type": "array"
-      },
-      "engagementType": {
-        "description": "pinterest_engagement: limit to one engagement action.",
-        "enum": [
-          "click",
-          "save",
-          "closeup",
-          "comment",
-          "like"
-        ],
-        "type": "string"
-      },
-      "engagerType": {
-        "enum": [
-          1,
-          2
-        ],
-        "type": "number"
-      },
-      "event": {
-        "maxLength": 100,
-        "type": "string"
-      },
-      "identityAuthorizedBcId": {
-        "description": "tiktok_engagement: required when identityType is BC_AUTH_TT.",
-        "type": "string"
-      },
-      "identityId": {
-        "type": "string"
-      },
-      "identityType": {
-        "description": "tiktok_engagement: type of `identityId`.",
-        "enum": [
-          "TT_USER",
-          "BC_AUTH_TT"
-        ],
-        "type": "string"
-      },
-      "lookbackDays": {
-        "description": "Required for engagement audiences. Rolling window.",
-        "enum": [
-          30,
-          60,
-          90,
-          180,
-          365
-        ],
-        "type": "number"
-      },
-      "matchRules": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "matchType": {
-              "enum": [
-                "EXACT",
-                "STARTS_WITH",
-                "CONTAINS",
-                "ENDS_WITH"
-              ],
-              "type": "string"
-            },
-            "matchValue": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "matchType",
-            "matchValue"
-          ],
-          "type": "object"
-        },
-        "maxItems": 50,
-        "minItems": 1,
-        "type": "array"
-      },
-      "name": {
-        "maxLength": 255,
-        "type": "string"
-      },
-      "pinIds": {
-        "items": {
-          "pattern": "^\\d+$",
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "pixelId": {
-        "type": "string"
-      },
-      "ratio": {
-        "maximum": 0.2,
-        "minimum": 0.01,
-        "type": "number"
-      },
-      "retentionDays": {
-        "maximum": 540,
-        "minimum": 1,
-        "type": "integer"
-      },
-      "rule": {
-        "type": "object"
-      },
-      "size": {
-        "enum": [
-          "narrow",
-          "balanced",
-          "broad"
-        ],
-        "type": "string"
-      },
-      "source": {
-        "description": "Required for tiktok_engagement: what people engaged with.",
-        "enum": [
-          "ads",
-          "organic_video",
-          "live_video",
-          "business_account"
-        ],
-        "type": "string"
-      },
-      "sourceAudienceId": {
-        "description": "Required for lookalike audiences",
-        "type": "string"
-      },
-      "sourceId": {
-        "description": "Required for meta_engagement: the Page / IG account / video id.",
-        "type": "string"
-      },
-      "sourceIds": {
-        "items": {
-          "type": "string"
-        },
-        "maxItems": 50,
-        "minItems": 1,
-        "type": "array"
-      },
-      "sourceType": {
-        "enum": [
-          "VIDEO_ADS",
-          "LEAD_GEN_FORMS",
-          "ORGANIZATION_PAGES",
-          "EVENT_PAGES",
-          "SINGLE_IMAGE_ADS"
-        ],
-        "type": "string"
-      },
-      "trigger": {
-        "type": "string"
-      },
-      "type": {
-        "enum": [
-          "customer_list",
-          "company_list",
-          "engagement",
-          "meta_engagement",
-          "tiktok_engagement",
-          "pinterest_engagement",
-          "website",
-          "website_retargeting",
-          "lookalike"
-        ],
-        "type": "string"
-      },
-      "urlContains": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "name",
-      "type"
-    ],
-    "type": "object"
-  },
-  {
-    "properties": {
-      "description": {
-        "type": "string"
-      },
-      "name": {
-        "maxLength": 255,
-        "type": "string"
-      },
-      "spec": {
-        "description": "The targeting spec to store.",
-        "properties": {
-          "ageMax": {
-            "maximum": 100,
-            "minimum": 13,
-            "type": "integer"
-          },
-          "ageMin": {
-            "maximum": 100,
-            "minimum": 13,
-            "type": "integer"
-          },
-          "audienceExclude": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "audienceInclude": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "behaviors": {
-            "items": {
-              "properties": {
-                "id": {
-                  "type": "string"
-                },
-                "name": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "id"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "cities": {
-            "items": {
-              "anyOf": [
-                {
-                  "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"
-                }
-              ]
-            },
-            "type": "array"
-          },
-          "companySizes": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "countries": {
-            "description": "ISO 3166-1 alpha-2 country codes (e.g. ['US']).",
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "countryGroups": {
-            "items": {
-              "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"
-            },
-            "type": "array"
-          },
-          "customLocations": {
-            "items": {
-              "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": {
-                  "description": "Positive radius around the point.",
-                  "type": "number"
-                }
-              },
-              "required": [
-                "latitude",
-                "longitude",
-                "radius",
-                "distanceUnit"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "excludedLocations": {
-            "properties": {
-              "cities": {
-                "items": {
-                  "properties": {
-                    "distanceUnit": {
-                      "description": "Required if radius is set.",
-                      "enum": [
-                        "mile",
-                        "kilometer"
-                      ],
-                      "type": "string"
-                    },
-                    "key": {
-                      "type": "string"
-                    },
-                    "radius": {
-                      "description": "Radius around the excluded city. Requires distanceUnit.",
-                      "type": "number"
-                    }
-                  },
-                  "required": [
-                    "key"
-                  ],
-                  "type": "object"
-                },
-                "type": "array"
-              },
-              "countries": {
-                "items": {
-                  "type": "string"
-                },
-                "type": "array"
-              },
-              "countryGroups": {
-                "items": {
-                  "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"
-                },
-                "type": "array"
-              },
-              "customLocations": {
-                "items": {
-                  "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": {
-                      "description": "Positive radius around the point.",
-                      "type": "number"
-                    }
-                  },
-                  "required": [
-                    "latitude",
-                    "longitude",
-                    "radius",
-                    "distanceUnit"
-                  ],
-                  "type": "object"
-                },
-                "type": "array"
-              },
-              "neighborhoods": {
-                "items": {
-                  "properties": {
-                    "key": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "key"
-                  ],
-                  "type": "object"
-                },
-                "type": "array"
-              },
-              "places": {
-                "items": {
-                  "properties": {
-                    "key": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "key"
-                  ],
-                  "type": "object"
-                },
-                "type": "array"
-              },
-              "regions": {
-                "items": {
-                  "properties": {
-                    "key": {
-                      "type": "string"
-                    },
-                    "name": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "key"
-                  ],
-                  "type": "object"
-                },
-                "type": "array"
-              },
-              "zips": {
-                "items": {
-                  "properties": {
-                    "key": {
-                      "type": "string"
-                    },
-                    "name": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "key"
-                  ],
-                  "type": "object"
-                },
-                "type": "array"
-              }
-            },
-            "type": "object"
-          },
-          "gender": {
-            "enum": [
-              "all",
-              "male",
-              "female"
-            ],
-            "type": "string"
-          },
-          "incomeTier": {
-            "enum": [
-              "top_5",
-              "top_10",
-              "top_10_25",
-              "top_25_50"
-            ],
-            "type": "string"
-          },
-          "industries": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "interests": {
-            "items": {
-              "properties": {
-                "id": {
-                  "type": "string"
-                },
-                "name": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "id"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "jobFunctions": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "languages": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "metros": {
-            "items": {
-              "properties": {
-                "key": {
-                  "type": "string"
-                },
-                "name": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "key"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "regions": {
-            "items": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "properties": {
-                    "key": {
-                      "type": "string"
-                    },
-                    "name": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "key"
-                  ],
-                  "type": "object"
-                }
-              ]
-            },
-            "type": "array"
-          },
-          "seniorities": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "userDevice": {
-            "items": {
-              "minLength": 1,
-              "type": "string"
-            },
-            "minItems": 1,
-            "type": "array"
-          },
-          "userOs": {
-            "items": {
-              "minLength": 1,
-              "type": "string"
-            },
-            "minItems": 1,
-            "type": "array"
-          },
-          "workEmployers": {
-            "items": {
-              "properties": {
-                "id": {
-                  "type": "string"
-                },
-                "name": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "id"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "workIndustries": {
-            "items": {
-              "properties": {
-                "id": {
-                  "type": "string"
-                },
-                "name": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "id"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "workPositions": {
-            "items": {
-              "properties": {
-                "id": {
-                  "type": "string"
-                },
-                "name": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "id"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "zips": {
-            "items": {
-              "properties": {
-                "key": {
-                  "type": "string"
-                },
-                "name": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "key"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          }
-        },
-        "type": "object"
-      },
-      "type": {
-        "const": "saved_targeting",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "name",
-      "spec"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "properties": {
+      "adIds": {
+        "description": "pinterest_engagement: people who engaged with these ads.",
+        "items": {
+          "pattern": "^\\d+$",
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "campaignIds": {
+        "items": {
+          "pattern": "^\\d+$",
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "companies": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "domain": {
+              "maxLength": 100,
+              "type": "string"
+            },
+            "linkedinPageUrl": {
+              "type": "string"
+            },
+            "name": {
+              "maxLength": 255,
+              "type": "string"
+            },
+            "website": {
+              "maxLength": 100,
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "maxItems": 300000,
+        "minItems": 1,
+        "type": "array"
+      },
+      "country": {
+        "description": "2-letter code, required for lookalike audiences",
+        "type": "string"
+      },
+      "customerFileSource": {
+        "type": "string"
+      },
+      "description": {
+        "type": "string"
+      },
+      "engagementDomains": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "engagementSource": {
+        "enum": [
+          "page",
+          "instagram",
+          "video"
+        ],
+        "type": "string"
+      },
+      "engagementSources": {
+        "items": {
+          "type": "string"
+        },
+        "maxItems": 50,
+        "minItems": 1,
+        "type": "array"
+      },
+      "engagementType": {
+        "description": "pinterest_engagement: limit to one engagement action.",
+        "enum": [
+          "click",
+          "save",
+          "closeup",
+          "comment",
+          "like"
+        ],
+        "type": "string"
+      },
+      "engagerType": {
+        "enum": [
+          1,
+          2
+        ],
+        "type": "number"
+      },
+      "event": {
+        "maxLength": 100,
+        "type": "string"
+      },
+      "identityAuthorizedBcId": {
+        "description": "tiktok_engagement: required when identityType is BC_AUTH_TT.",
+        "type": "string"
+      },
+      "identityId": {
+        "type": "string"
+      },
+      "identityType": {
+        "description": "tiktok_engagement: type of `identityId`.",
+        "enum": [
+          "TT_USER",
+          "BC_AUTH_TT"
+        ],
+        "type": "string"
+      },
+      "lookbackDays": {
+        "description": "Required for engagement audiences. Rolling window.",
+        "enum": [
+          30,
+          60,
+          90,
+          180,
+          365
+        ],
+        "type": "number"
+      },
+      "matchRules": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "matchType": {
+              "enum": [
+                "EXACT",
+                "STARTS_WITH",
+                "CONTAINS",
+                "ENDS_WITH"
+              ],
+              "type": "string"
+            },
+            "matchValue": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "matchType",
+            "matchValue"
+          ],
+          "type": "object"
+        },
+        "maxItems": 50,
+        "minItems": 1,
+        "type": "array"
+      },
+      "name": {
+        "maxLength": 255,
+        "type": "string"
+      },
+      "pinIds": {
+        "items": {
+          "pattern": "^\\d+$",
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "pixelId": {
+        "type": "string"
+      },
+      "ratio": {
+        "maximum": 0.2,
+        "minimum": 0.01,
+        "type": "number"
+      },
+      "retentionDays": {
+        "maximum": 540,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "rule": {
+        "type": "object"
+      },
+      "size": {
+        "enum": [
+          "narrow",
+          "balanced",
+          "broad"
+        ],
+        "type": "string"
+      },
+      "source": {
+        "description": "Required for tiktok_engagement: what people engaged with.",
+        "enum": [
+          "ads",
+          "organic_video",
+          "live_video",
+          "business_account"
+        ],
+        "type": "string"
+      },
+      "sourceAudienceId": {
+        "description": "Required for lookalike audiences",
+        "type": "string"
+      },
+      "sourceId": {
+        "type": "string"
+      },
+      "sourceIds": {
+        "items": {
+          "type": "string"
+        },
+        "maxItems": 50,
+        "minItems": 1,
+        "type": "array"
+      },
+      "sourceType": {
+        "enum": [
+          "VIDEO_ADS",
+          "LEAD_GEN_FORMS",
+          "ORGANIZATION_PAGES",
+          "EVENT_PAGES",
+          "SINGLE_IMAGE_ADS"
+        ],
+        "type": "string"
+      },
+      "trigger": {
+        "type": "string"
+      },
+      "type": {
+        "enum": [
+          "customer_list",
+          "company_list",
+          "engagement",
+          "meta_engagement",
+          "tiktok_engagement",
+          "pinterest_engagement",
+          "website",
+          "website_retargeting",
+          "lookalike"
+        ],
+        "type": "string"
+      },
+      "urlContains": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "name",
+      "type"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "description": {
+        "type": "string"
+      },
+      "name": {
+        "maxLength": 255,
+        "type": "string"
+      },
+      "spec": {
+        "description": "The targeting spec to store.",
+        "properties": {
+          "ageMax": {
+            "maximum": 100,
+            "minimum": 13,
+            "type": "integer"
+          },
+          "ageMin": {
+            "maximum": 100,
+            "minimum": 13,
+            "type": "integer"
+          },
+          "audienceExclude": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "audienceInclude": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "behaviors": {
+            "items": {
+              "properties": {
+                "id": {
+                  "type": "string"
+                },
+                "name": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "id"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "cities": {
+            "items": {
+              "anyOf": [
+                {
+                  "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"
+                }
+              ]
+            },
+            "type": "array"
+          },
+          "companySizes": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "countries": {
+            "description": "ISO 3166-1 alpha-2 country codes (e.g. ['US']).",
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "countryGroups": {
+            "items": {
+              "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"
+            },
+            "type": "array"
+          },
+          "customLocations": {
+            "items": {
+              "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": {
+                  "description": "Positive radius around the point.",
+                  "type": "number"
+                }
+              },
+              "required": [
+                "latitude",
+                "longitude",
+                "radius",
+                "distanceUnit"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "excludedLocations": {
+            "properties": {
+              "cities": {
+                "items": {
+                  "properties": {
+                    "distanceUnit": {
+                      "description": "Required if radius is set.",
+                      "enum": [
+                        "mile",
+                        "kilometer"
+                      ],
+                      "type": "string"
+                    },
+                    "key": {
+                      "type": "string"
+                    },
+                    "radius": {
+                      "description": "Radius around the excluded city. Requires distanceUnit.",
+                      "type": "number"
+                    }
+                  },
+                  "required": [
+                    "key"
+                  ],
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "countries": {
+                "items": {
+                  "type": "string"
+                },
+                "type": "array"
+              },
+              "countryGroups": {
+                "items": {
+                  "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"
+                },
+                "type": "array"
+              },
+              "customLocations": {
+                "items": {
+                  "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": {
+                      "description": "Positive radius around the point.",
+                      "type": "number"
+                    }
+                  },
+                  "required": [
+                    "latitude",
+                    "longitude",
+                    "radius",
+                    "distanceUnit"
+                  ],
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "neighborhoods": {
+                "items": {
+                  "properties": {
+                    "key": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "key"
+                  ],
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "places": {
+                "items": {
+                  "properties": {
+                    "key": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "key"
+                  ],
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "regions": {
+                "items": {
+                  "properties": {
+                    "key": {
+                      "type": "string"
+                    },
+                    "name": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "key"
+                  ],
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "zips": {
+                "items": {
+                  "properties": {
+                    "key": {
+                      "type": "string"
+                    },
+                    "name": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "key"
+                  ],
+                  "type": "object"
+                },
+                "type": "array"
+              }
+            },
+            "type": "object"
+          },
+          "gender": {
+            "enum": [
+              "all",
+              "male",
+              "female"
+            ],
+            "type": "string"
+          },
+          "incomeTier": {
+            "enum": [
+              "top_5",
+              "top_10",
+              "top_10_25",
+              "top_25_50"
+            ],
+            "type": "string"
+          },
+          "industries": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "interests": {
+            "items": {
+              "properties": {
+                "id": {
+                  "type": "string"
+                },
+                "name": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "id"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "jobFunctions": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "languages": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "metros": {
+            "items": {
+              "properties": {
+                "key": {
+                  "type": "string"
+                },
+                "name": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "key"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "regions": {
+            "items": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "properties": {
+                    "key": {
+                      "type": "string"
+                    },
+                    "name": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "key"
+                  ],
+                  "type": "object"
+                }
+              ]
+            },
+            "type": "array"
+          },
+          "seniorities": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "userDevice": {
+            "items": {
+              "minLength": 1,
+              "type": "string"
+            },
+            "minItems": 1,
+            "type": "array"
+          },
+          "userOs": {
+            "items": {
+              "minLength": 1,
+              "type": "string"
+            },
+            "minItems": 1,
+            "type": "array"
+          },
+          "workEmployers": {
+            "items": {
+              "properties": {
+                "id": {
+                  "type": "string"
+                },
+                "name": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "id"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "workIndustries": {
+            "items": {
+              "properties": {
+                "id": {
+                  "type": "string"
+                },
+                "name": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "id"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "workPositions": {
+            "items": {
+              "properties": {
+                "id": {
+                  "type": "string"
+                },
+                "name": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "id"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "zips": {
+            "items": {
+              "properties": {
+                "key": {
+                  "type": "string"
+                },
+                "name": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "key"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          }
+        },
+        "type": "object"
+      },
+      "type": {
+        "const": "saved_targeting",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "name",
+      "spec"
+    ],
+    "type": "object"
+  }
+]
  3. First observed

TDQS

A3.6/5.0
Behavior4/5

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

Annotations already declare destructiveHint=true, openWorldHint=true, and idempotentHint=false. The description adds meaningful context beyond that: a required preview-then-owner-approval flow, requestId reuse for recovery, and the 'claim live only when status is active' success condition. It doesn't describe payload validation or failure modes, but the added confirmation semantics are substantive.

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?

The confirmation constraint and success condition are front-loaded and each sentence carries weight. The trailing 'Fields: soclo://tools/...' line is terse to the point of being cryptic and doesn't itself explain anything, a minor inefficiency.

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?

For a destructive, nested-payload creation tool with no output schema and 60% schema coverage, the description covers the approval workflow but leaves the payload shape and audience-type variations unexplained. Delegating 'Fields' to an external URI leaves a gap an agent must fill from the schema alone.

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 coverage is 60%, with descriptions on confirm, requestId, adAccountId, and the expected* fields. The description reinforces confirm/requestId semantics but does nothing for the large nested payload structure or the many audience-type variants, so it doesn't compensate for the coverage gap. Baseline 3 is appropriate.

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 states a specific verb and resource ('Create custom audience') and scopes it to Soclo Ads, so the action is unambiguous. It does not differentiate from close siblings such as soclo_ads_update_ad_audience or soclo_ads_add_users_to_ad_audience, leaving the agent to infer which variant applies.

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

Usage Guidelines3/5

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

It gives the confirmation protocol ('preview, then owner-approved confirm:true with the same requestId') which is genuine when-to-use workflow guidance. However, it never says when to create versus update or replace an audience, and offers no alternatives among siblings.

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

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