---
title: "/2026-01/marketing-solutions/ad-sets"
method: PATCH
path: "/2026-01/marketing-solutions/ad-sets"
tags: ["Campaign"]
---

# /2026-01/marketing-solutions/ad-sets

`PATCH /2026-01/marketing-solutions/ad-sets`

Patch a list of AdSets.

## Request body

- RequestsPatchAdSetV24Q3 — List of input resources
  - `data` WriteModelPatchAdSetV24Q3[], nullable
    - `attributes` PatchAdSetV24Q3 — ad set patch model
      - `attributionConfiguration` PatchAdSetAttributionConfigurationV24Q3 — Patch model for an ad set's attribution configuration.
        - `attributionMethod` 'unknown' | 'criteoAttribution' | 'googleAnalyticsLastClick' | 'googleAnalyticsDataDriven' | 'lastClick' | 'postClick', nullable — The attribution method.
        - `lookbackWindow` 'unknown' | '30M' | '24H' | '7D' | '30D', nullable — The lookback window. Optional, should be specified only for attribution methods PostClick and LastClick.
      - `bidding` PatchAdSetBiddingV24Q3 — ad set bidding patch model
        - `bidAmount` NillableDecimal, nullable — Placeholder object for value for which "null" is a valid business value
          - `value` number, double, nullable — The value. If missing or null the value is set to "null"
      - `budget` PatchAdSetBudgetV24Q3 — ad set budget patch model
        - `budgetAmount` NillableDecimal, nullable — Placeholder object for value for which "null" is a valid business value
          - `value` number, double, nullable — The value. If missing or null the value is set to "null"
        - `budgetDeliverySmoothing` 'accelerated' | 'standard', nullable
        - `budgetDeliveryWeek` 'undefined' | 'mondayToSunday' | 'tuesdayToMonday' | 'wednesdayToTuesday' | 'thursdayToWednesday' | 'fridayToThursday' | 'saturdayToFriday' | 'sundayToSaturday', nullable
        - `budgetRenewal` 'undefined' | 'daily' | 'monthly' | 'lifetime' | 'weekly', nullable
        - `budgetStrategy` 'capped' | 'uncapped', nullable
      - `name` string, nullable
      - `scheduling` PatchAdSetSchedulingV24Q3 — ad set schedule patch model
        - `endDate` NillableDateTime, nullable — structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided.
          - `value` string, date-time, nullable
        - `startDate` NillableDateTime, nullable — structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided.
          - `value` string, date-time, nullable
      - `targeting` AdSetTargetingV24Q3, nullable — ad set targeting model
        - `deliveryLimitations` AdSetDeliveryLimitationsV24Q3, nullable — ad set delivery limitations model
          - `devices` string[], nullable
          - `environments` string[], nullable
          - `operatingSystems` string[], nullable
        - `frequencyCapping` object, nullable
          - `value` AdSetFrequencyCappingV24Q3, nullable — ad set frequency capping model
            - `frequency` 'hourly' | 'daily' | 'lifetime' | 'advanced', nullable
            - `maximumImpressions` integer, nullable
        - `geoLocation` AdSetGeoLocationV24Q3, nullable — ad set geolocation model
          - `countries` NillableAdSetTargetingRuleV24Q3, nullable — structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided.
            - `value` AdSetTargetingRuleV24Q3 — ad set targeting rule model
              - …
          - `subdivisions` NillableAdSetTargetingRuleV24Q3, nullable — structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided.
            - `value` AdSetTargetingRuleV24Q3 — ad set targeting rule model
              - …
          - `zipCodes` NillableAdSetTargetingRuleV24Q3, nullable — structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided.
            - `value` AdSetTargetingRuleV24Q3 — ad set targeting rule model
              - …
    - `id` string, nullable — Id of the entity
    - `type` string, nullable — Canonical type name of the entity

## Response `200`

List of patched adSets.

- ResponsesAdSetIdV24Q3 — List of output resources
  - `data` ReadModelAdSetIdV24Q3[], nullable
    - `attributes` AdSetIdV24Q3, nullable — ad set id model
    - `id` string, nullable — Id of the entity
    - `type` string, nullable
  - `errors` CommonProblem[], nullable
    - `code` string, nullable — A machine-readable error code, expressed as a string value.
    - `detail` string, nullable — A human-readable explanation specific to this occurrence of the problem
    - `instance` string, nullable — A URI that identifies the specific occurrence of the problem.
    - `source` object, nullable — A machine-readable structure to reference to the exact location(s) causing the error(s)
    - `stackTrace` string, nullable
    - `title` string, nullable — A short human-readable description of the problem type
    - `traceId` string, nullable — The request correlation ID this problem comes from.
    - `traceIdentifier` string, nullable — The request correlation ID this problem comes from. (deprecated, use traceId instead)
    - `type` 'unknown' | 'access-control' | 'authentication' | 'authorization' | 'availability' | 'deprecation' | 'quota' | 'validation', nullable — The problem's category.
  - `warnings` CommonProblem[], nullable
    - `code` string, nullable — A machine-readable error code, expressed as a string value.
    - `detail` string, nullable — A human-readable explanation specific to this occurrence of the problem
    - `instance` string, nullable — A URI that identifies the specific occurrence of the problem.
    - `source` object, nullable — A machine-readable structure to reference to the exact location(s) causing the error(s)
    - `stackTrace` string, nullable
    - `title` string, nullable — A short human-readable description of the problem type
    - `traceId` string, nullable — The request correlation ID this problem comes from.
    - `traceIdentifier` string, nullable — The request correlation ID this problem comes from. (deprecated, use traceId instead)
    - `type` 'unknown' | 'access-control' | 'authentication' | 'authorization' | 'availability' | 'deprecation' | 'quota' | 'validation', nullable — The problem's category.

---

[API](https://skmtc.net/criteo/apis/criteo-api.md) · [All operations](https://skmtc.net/criteo/apis/criteo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/criteo/criteo-api/versions/c1721589426a/schema)