addedInput schema / properties / campaign_data / properties / x
Added value: +{
+ "additionalProperties": false,
+ "description": "X (Twitter) campaign configuration: audiences or target groups, image ads and landing page offers. X takes no objective or bid here (its launch sets them), launching needs X connected, and once launched an X campaign is view-only.",
+ "properties": {
+ "ads": {
+ "additionalProperties": false,
+ "properties": {
+ "groups": {
+ "description": "Named Metadata platform ad groups, ONLY when explicitly requested. Each group needs at least two distinct X ads. Names are capped at 50 characters.",
+ "items": {
+ "properties": {
+ "ads": {
+ "items": {
+ "type": "integer"
+ },
+ "type": "array"
+ },
+ "name": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "ads"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "list": {
+ "description": "Array of X ad IDs (from create_update_image_ad with channels=['X']), attached individually. Default unless the user explicitly asks for grouped ads.",
+ "items": {
+ "type": "integer"
+ },
+ "type": "array"
+ }
+ },
+ "type": "object"
+ },
+ "audiences": {
+ "description": "Array of X audience names: firmographic, technographic, intent, store leads, contact or account CSV uploads, website retargeting contacts, marketing automation lists, HubSpot account lists and dynamic Salesforce lists (the types the platform UI offers for X). Audiences native to another channel (LinkedIn, Facebook, Display, or another channel's retargeting), static Salesforce or G2 Intent lists and Express Firmographic cannot go to X. An audience exists on X only after the platform has uploaded it to a CONNECTED X account, and it blocks the launch until it is READY with at least 100 matched users.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "dailyBudget": {
+ "description": "Daily budget in USD for this channel (platform minimum $10). Applied through the platform's own channel budget endpoint; without it the channel keeps the platform default of $50/day. Derive from the approved split (e.g. monthly channel budget / 30, rounded to cents).",
+ "minimum": 10,
+ "type": "number"
+ },
+ "offers": {
+ "description": "Array of offer IDs for X. MUST contain ONLY Landing Page offer_ids: X has no Lead Gen forms, and the X card clicks through to the landing page (plus UTMs). A Lead Gen offer_id is refused and reported in errors.",
+ "items": {
+ "type": "integer"
+ },
+ "type": "array"
+ },
+ "target_groups": {
+ "description": "Array of Targeting Group names for X: groups built for X in the platform's Targeting Groups section, whose interests, keywords and locations the X launch reads. These are NOT audiences.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "ads",
+ "offers"
+ ],
+ "type": "object"
+}