changedInput schema / properties / body / properties / cta / description
Previous value: -"Call to action type"New value: +"Call-to-action button. Valid values depend on the parent campaign objective (and, for sales, the ad set `conversionLocation`) — OUTCOME_LEADS: `APPLY_NOW`, `DOWNLOAD`, `GET_OFFER`, `GET_QUOTE`, `LEARN_MORE`, `SIGN_UP`, `SUBSCRIBE`; OUTCOME_TRAFFIC: `APPLY_NOW`, `BOOK_TRAVEL`, `BUY_NOW`, `CONTACT_US`, `GET_OFFER`, `GET_PROMOTIONS`, `GET_QUOTE`, `LEARN_MORE`, `NO_BUTTON`, `ORDER_NOW`, `SHOP_NOW`, `SIGN_UP`, `SUBSCRIBE`; OUTCOME_ENGAGEMENT: `APPLY_NOW`, `BOOK_TRAVEL`, `CONTACT_US`, `GET_PROMOTIONS`, `GET_QUOTE`, `INQUIRE_NOW`, `LEARN_MORE`, `MESSAGE_PAGE`, `ORDER_NOW`, `SEND_UPDATES`, `SHOP_NOW`, `SIGN_UP`, `SUBSCRIBE`; OUTCOME_SALES with `conversionLocation: messaging`: `APPLY_NOW`, `BOOK_TRAVEL`, `CONTACT_US`, `GET_QUOTE`, `LEARN_MORE`, `MESSAGE_PAGE`, `ORDER_NOW`, `PLAY_GAME`, `SHOP_NOW`, `SIGN_UP`, `SUBSCRIBE`; OUTCOME_SALES with `conversionLocation: website`: `APPLY_NOW`, `BOOK_TRAVEL`, `BUY_TICKETS`, `CONTACT_US`, `GET_OFFER`, `GET_QUOTE`, `GET_SHOWTIMES`, `LEARN_MORE`, `LISTEN_NOW`, `ORDER_NOW`, `PLAY_GAME`, `SHOP_NOW`, `SIGN_UP`, `SUBSCRIBE`, `WATCH_MORE`. Note `BOOK_TRAVEL` is the \"Book now\" button. Not validated server-side, so values outside this set are forwarded to Facebook and may be rejected there."
changedInput schema / properties / body / properties / description / description
Previous value: -"Ad description text"New value: +"Single ad description. SINGLE (image and video) ads take their description from the `descriptions` array, and carousel cards from `media[].description`."
addedInput schema / properties / body / properties / descriptions
Added value: +{
+ "description": "Description variants. Applies to SINGLE (image and video) ads only — carousel ads take their per-card description from `media[].description`. Supply more than one to run Facebook text variations.",
+ "example": [
+ {
+ "text": "Automation Test Description"
+ }
+ ],
+ "items": {
+ "properties": {
+ "text": {
+ "description": "Description variant",
+ "example": "Automation Test Description",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+}
changedInput schema / properties / body / properties / headline / description
Previous value: -"Ad headline text"New value: +"Ad-level headline for CAROUSEL ads — used for any card that does not set its own `media[].headline`. SINGLE (image and video) ads take their headline from the `headlines` array instead."
addedInput schema / properties / body / properties / headlines
Added value: +{
+ "description": "Headline variants. Applies to SINGLE (image and video) ads only — carousel ads take their per-card headline from `media[].headline`, falling back to the singular `headline`. Supply more than one to run Facebook text variations.",
+ "example": [
+ {
+ "text": "Automation Test Headline"
+ },
+ {
+ "text": "Automation Test Headline1"
+ }
+ ],
+ "items": {
+ "properties": {
+ "text": {
+ "description": "Headline variant",
+ "example": "Automation Test Headline",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+}
changedInput schema / properties / body / properties / media / items / properties / type / example
Previous value: -"IMAGE"New value: +"image"
addedInput schema / properties / body / properties / media / items / title
Added value: +"MediaDTO"
changedInput schema / properties / body / properties / primaryText / description
Previous value: -"Ad primary text"New value: +"Single primary text. Normalised into `primaryTexts` when that array is empty, so send `primaryTexts` instead unless you have exactly one variant."
addedInput schema / properties / body / properties / primaryTexts
Added value: +{
+ "description": "Primary text variants. Used by every media type. Supply more than one to run Facebook text variations; with a single entry it becomes the ad message. Prefer this over the singular `primaryText`.",
+ "example": [
+ {
+ "text": "Automation Test Primary Text"
+ }
+ ],
+ "items": {
+ "properties": {
+ "text": {
+ "description": "Primary text variant",
+ "example": "Automation Test Primary Text",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+}
addedInput schema / properties / body / title
Added value: +"UpsertAdDTO"