account | DynamicAccount | Yes | - | Select Pinterest Ads account to update ad group budgets in. |
update_type | string or SelectableOption | Yes | - | Choose whether to update a single ad group budget or multiple at once. Options: single or bulk. |
ad_group_id | string or SelectItem | No | - | Pinterest ad group ID to update. Required for single update. |
budget_value | number | No | - | The new budget in the ad account’s currency (for example 20 for $20). Markifact converts it to Pinterest microcurrency automatically. Whether it acts as a daily or lifetime budget follows the ad group’s existing budget type. Not applicable to ad groups in CBO campaigns, where the campaign generates budgets. Required for single update. |
structured_data | array (also accepts a comma-separated string) | No | - | Use only when update_type is bulk. Required columns: ad_group_id and budget_value (in the ad account’s currency). Up to 100 rows. |