account | DynamicAccount | Yes | - | Select Meta Ads account, ask the user for it if not provided |
adset_id | string or SelectItem | Yes | - | The ad set to update placements for |
placement_mode | string or SelectableOption | Yes | - | Choose ‘AUTOMATIC’ to switch to Advantage+ placements (Meta optimizes automatically) or ‘MANUAL’ to explicitly set publisher platforms, device platforms, and positions. AUTOMATIC removes all placement restrictions; MANUAL replaces existing placements with the ones specified. |
publisher_platforms | array of string or SelectableOption | No | - | Required for MANUAL mode. Platforms to show ads on. This replaces the current publisher platforms — only the selected ones will be active. Options: FACEBOOK, INSTAGRAM, THREADS, MESSENGER, AUDIENCE_NETWORK |
device_platforms | array of string or SelectableOption | No | - | Optional for MANUAL mode. Device types to target. This replaces the current device setting — only the selected devices will be targeted. Leave empty to keep all devices. Options: MOBILE, DESKTOP |
positions | array of string or SelectableOption | No | - | Optional for MANUAL mode. Specific ad positions/placements to target. Only the selected positions will be active — any previous positions are replaced. Leave empty to use all positions for the selected publisher platforms. |