The duplicated ad set as a new draft, with copies of its ads
idstringrequired
Ad set identifier
Example:6a323f3f4454921db1498cd8
namestringrequired
Ad set name
Example:Ad set 1
campaignIdstringrequired
Parent campaign id
Example:6a323f3e4454921db1498ccf
fbAdSetIdstring
Facebook ad set id, set once published
Example:120250378906150122
publishingStatusstringrequired
Publishing status. On a published entity this is not the state you asked for but the effective_status Meta reports, mapped back — a pause or resume re-reads it live, so an ad awaiting review comes back IN_REVIEW rather than PAUSED or PUBLISHED. Any effective status this service does not recognise also maps to IN_REVIEW.
Available optionsDRAFTSCHEDULEDPUBLISHINGPUBLISHEDPAUSEDIN_REVIEWWITH_ISSUESREJECTEDARCHIVEDFAILED
Example:PUBLISHED
fbErrorstringnullable
Publish error from Facebook. null on reads when there is none.
Example:null
pageIdstringrequired
Page the ads run under
Example:196684453527082
instagramActorIdstringnullable
Instagram account the ads run under. null when not linked.
Example:null
messagingPlatformsstring[]required
Messaging destinations for click-to-message ads. Empty for other conversion locations.
Example:["MESSENGER","INSTAGRAM_DIRECT"]
conversionLocationstring
Where the conversion happens
Example:on_ad
budgetobjectrequired
Budget configuration
budget.budgetTypestringrequired
Budget cadence
Example:DAILY
budget.amountnumberrequired
Budget amount as entered
Example:1
budget.actualAmountnumber
Amount actually applied. Differs from amount on connect-your-BM pricing.
Example:1
audienceobjectrequired
Targeting
audience.gendersnumber[]required
Genders as Facebook numeric codes, not names — 0 all, 1 male, 2 female. Empty array also means all.
Placement positions per platform. Only meaningful when placementType is manual.
audience.placements.property name*any
Placement positions per platform. Only meaningful when placementType is manual.
audience.placementTypestring
Placement strategy
Available optionsautomanual
Example:manual
unpublishedChangesboolean
Whether the ad set has edits not yet published
Example:false
createdAtstringrequired
Created at
Example:2026-06-17T06:31:27.129Z
updatedAtstringrequired
Updated at
Example:2026-08-19T11:42:35.835Z
adsobject[]required
Ads in this ad set
ads[].idstringrequired
Ad identifier
Example:6a323f3f4454921db1498ce1
ads[].namestringrequired
Ad name
Example:Ad 1
ads[].campaignIdstringrequired
Parent campaign id
Example:6a323f3e4454921db1498ccf
ads[].adsetIdstringrequired
Parent ad set id
Example:6a323f3f4454921db1498cd8
ads[].fbAdIdstring
Facebook ad id, set once published
Example:120250378908850122
ads[].publishingStatusstringrequired
Publishing status. On a published entity this is not the state you asked for but the effective_status Meta reports, mapped back — a pause or resume re-reads it live, so an ad awaiting review comes back IN_REVIEW rather than PAUSED or PUBLISHED. Any effective status this service does not recognise also maps to IN_REVIEW.
Available optionsDRAFTSCHEDULEDPUBLISHINGPUBLISHEDPAUSEDIN_REVIEWWITH_ISSUESREJECTEDARCHIVEDFAILED
Example:PUBLISHED
ads[].fbErrorstringnullable
Publish error from Facebook. null on reads when there is none.
Example:null
ads[].mediaTypestringrequired
Creative format
Example:SINGLE
ads[].ctastring
Call-to-action button
Example:GET_OFFER
ads[].multiAdvertiserAdsbooleanrequired
Whether multi-advertiser ads are enabled
Example:true
ads[].primaryTextsobject[]required
Primary text variants. Used by SINGLE image and video ads.
ads[].primaryTexts[].textstringrequired
Variant text. May be an empty string for an unused slot.
Example:Book a free demo
ads[].primaryTexts[]._idstring
Mongo subdocument id. Note _id, not id — the transform applies to the top-level document only.
Example:6a3245204454921db1499735
ads[].headlinesobject[]required
Headline variants
ads[].headlines[].textstringrequired
Variant text. May be an empty string for an unused slot.
Example:Book a free demo
ads[].headlines[]._idstring
Mongo subdocument id. Note _id, not id — the transform applies to the top-level document only.
Example:6a3245204454921db1499735
ads[].descriptionsobject[]required
Description variants
ads[].descriptions[].textstringrequired
Variant text. May be an empty string for an unused slot.
Example:Book a free demo
ads[].descriptions[]._idstring
Mongo subdocument id. Note _id, not id — the transform applies to the top-level document only.
Example:6a3245204454921db1499735
ads[].primaryTextstring
Single primary text. Carried alongside primaryTexts, mirroring its first entry.
Example:Get an instant estimate
ads[].headlinestring
Single headline. Used by carousel ads; mirrors the first headlines entry otherwise.