# Criteo

> Run Criteo campaigns from your workflows: change budgets and bids, start and stop ad sets, keep contact lists and audiences up to date, pull performance reports, and start workflows when campaigns appear, ad sets change status or daily spend passes an amount.

App · 25 actions. Web page: https://docs.lodol.com/docs/integrations/criteo

## Actions

### Add people to contact list

Add people to a contact list by email, phone number or another identifier. Criteo updates audiences twice a day, so ads reach them within hours.

**Inputs**

- Contact list (`segment_id`, text, required): The contact list segment. Pick one, or give its ID from 'Create contact list' or an earlier step.
- Identifier type (`identifier_type`, text): What the people are given as. Emails may be plain or hashed (MD5, SHA-256); phone numbers need their country code, like +33... Defaults to email. One of: `email` (Email address (plain or hashed)), `phoneNumber` (Phone number), `madid` (Mobile advertising ID), `identityLink` (LiveRamp IdentityLink), `gum` (Criteo GUM ID). Default: `email`.
- People (`identifiers`, list, required): The identifiers, all of the type chosen, up to 50,000.
- GUM caller ID (`gum_caller_id`, text): Only for GUM IDs: the caller ID your Criteo account team gave you. Only when Identifier type is Criteo GUM ID.

**Outputs**

- `identifier_type` (text): The identifier type
- `invalid_count` (number): How many it couldn't read
- `operation` (text): add or remove
- `requested_at` (text): When Criteo took the change
- `sample_invalid` (list): Some of those it couldn't read
- `segment_id` (text): The contact list
- `valid_count` (number): How many identifiers Criteo accepted

**Example output**

```json
{
  "identifier_type": "email",
  "invalid_count": 0,
  "operation": "add",
  "requested_at": "2026-12-10T10:00:50.000Z",
  "sample_invalid": [],
  "segment_id": "1001",
  "valid_count": 2
}
```

### Create audience

Build an audience from segments: people in any (or all) of the segments you include, less those in the ones you leave out. Then target an ad set at it.

**Inputs**

- Advertiser (`advertiser_id`, text, required): The advertiser. Pick one, or give its ID from an earlier step.
- Name (`name`, text, required): The audience's name.
- Segments to include (`include_segment_ids`, list, required): The segments whose people it reaches.
- People who are (`match`, text): With several segments to include: people in any of them, or only those in all. Defaults to any. One of: `any` (In any of the segments), `all` (In all of the segments). Default: `any`.
- Segments to leave out (`exclude_segment_ids`, list): People in any of these are left out.
- Description (`description`, text): A note about who it reaches.

**Outputs**

- `audience` (object): The new audience

**Example output**

```json
{
  "audience": {
    "adSetIds": [],
    "advertiserId": "4949",
    "algebra": {
      "and": [
        {
          "or": [
            {
              "audienceSegmentId": "42914"
            },
            {
              "audienceSegmentId": "19234"
            }
          ]
        },
        {
          "not": {
            "audienceSegmentId": "3482"
          }
        }
      ]
    },
    "createdAt": "2026-07-04T00:00:00Z",
    "description": "An audience which targets people of interest",
    "id": "1001",
    "name": "My audience",
    "updatedAt": null
  }
}
```

### Create contact list

Create an empty contact list segment for an advertiser, to fill with 'Add people to contact list'.

**Inputs**

- Advertiser (`advertiser_id`, text, required): The advertiser. Pick one, or give its ID from an earlier step.
- Name (`name`, text, required): The contact list's name, unique for the advertiser.
- Description (`description`, text): A note about who is on it.

**Outputs**

- `segment` (object): The new segment

**Example output**

```json
{
  "segment": {
    "advertiserId": "4949",
    "contactList": {
      "isReadOnly": false
    },
    "createdAt": "2026-05-09T16:30:50.4633333",
    "description": "Contact list description",
    "id": "1001",
    "name": "My contact list segment",
    "type": "ContactList",
    "updatedAt": null
  }
}
```

### Delete audience

Delete an audience. Its segments stay.

**Inputs**

- Audience (`audience_id`, text, required): The audience. Pick one, or give its ID from an earlier step.

**Outputs**

- `audience_id` (text): The audience deleted
- `deleted` (true/false): True once deleted

**Example output**

```json
{
  "audience_id": "1001",
  "deleted": true
}
```

### Delete audience segment

Delete an audience segment, such as a contact list. Segments made by Criteo can't be deleted.

**Inputs**

- Segment (`segment_id`, text, required): The audience segment's ID, from 'Search audience segments' or an earlier step. Contact lists are offered to pick from.

**Outputs**

- `deleted` (true/false): True once deleted
- `segment_id` (text): The segment deleted

**Example output**

```json
{
  "deleted": true,
  "segment_id": "1001"
}
```

### Empty contact list

Take everyone off a contact list. The list itself stays, ready to fill again.

**Inputs**

- Contact list (`segment_id`, text, required): The contact list segment. Pick one, or give its ID from 'Create contact list' or an earlier step.

**Outputs**

- `cleared` (true/false): True once emptied
- `segment_id` (text): The contact list

**Example output**

```json
{
  "cleared": true,
  "segment_id": "1001"
}
```

### Get ad set

Get one ad set with its status, schedule, bid, budget and targeting.

**Inputs**

- Ad set (`ad_set_id`, text, required): The ad set. Pick one, or give its ID from an earlier step.

**Outputs**

- `activation_status` (text): on or off: whether it is set to deliver
- `ad_set` (object): The ad set
- `budget_amount` (number): The budget in the advertiser's currency, empty if no limit
- `delivery_status` (text): Whether it delivers, such as live, paused, scheduled or ended

**Example output**

```json
{
  "activation_status": "on",
  "ad_set": {
    "adSetType": "standard",
    "advertiserId": "12345",
    "attributionConfiguration": {
      "attributionMethod": "criteoAttribution",
      "lookbackWindow": null
    },
    "bidding": {
      "bidAmount": 0.9,
      "costController": "maxCPC"
    },
    "budget": {
      "budgetAmount": 123.45,
      "budgetDeliverySmoothing": "standard",
      "budgetDeliveryWeek": "mondayToSunday",
      "budgetRenewal": "weekly",
      "budgetStrategy": "capped",
      "pacingBehavior": "targetFullBudget"
    },
    "campaignId": "99999",
    "datasetId": "6789",
    "destinationEnvironment": "web",
    "id": "123467",
    "mediaType": "display",
    "name": "Campaign A",
    "objective": "conversions",
    "schedule": {
      "activationStatus": "on",
      "deliveryStatus": "live",
      "endDate": {
        "value": null
      },
      "startDate": {
        "value": "2026-11-13T00:00:00Z"
      }
    },
    "scheduledBudgets": [],
    "targeting": {
      "deliveryLimitations": {
        "devices": [
          "mobile",
          "tablet",
          "desktop"
        ]
      },
      "frequencyCapping": {
        "frequency": "hourly",
        "maximumImpressions": 3
      },
      "geoLocation": {
        "countries": {
          "operand": "in",
          "values": [
            "FR"
          ]
        }
      }
    },
    "videoChannel": null
  },
  "budget_amount": 123.45,
  "delivery_status": "live"
}
```

### Get campaign

Get one campaign with its goal, spend limit and budget automation.

**Inputs**

- Campaign (`campaign_id`, text, required): The campaign. Pick one, or give its ID from an earlier step.

**Outputs**

- `campaign` (object): The campaign
- `spend_limit_amount` (number): The spend limit in the advertiser's currency, empty if none
- `spend_limit_renewal` (text): daily, monthly or lifetime; undefined if no limit
- `spend_limit_type` (text): capped or uncapped

**Example output**

```json
{
  "campaign": {
    "advertiserId": "12345",
    "budgetAutomation": {
      "automatedBudgetConfiguration": null,
      "enabled": false
    },
    "goal": "retention",
    "id": "99999",
    "name": "My Campaign",
    "scheduledSpendLimits": [],
    "sellerId": null,
    "spendLimit": {
      "spendLimitAmount": {
        "value": 123.45
      },
      "spendLimitRenewal": "daily",
      "spendLimitType": "capped"
    }
  },
  "spend_limit_amount": 123.45,
  "spend_limit_renewal": "daily",
  "spend_limit_type": "capped"
}
```

### Get contact list statistics

See how many identifiers a contact list holds and how many of them Criteo matched to people it can show ads to.

**Inputs**

- Contact list (`segment_id`, text, required): The contact list segment. Pick one, or give its ID from 'Create contact list' or an earlier step.

**Outputs**

- `match_rate` (number): The share matched, from 0 to 1
- `number_of_identifiers` (number): How many identifiers it holds
- `number_of_matches` (number): How many Criteo matched to people
- `segment_id` (text): The contact list

**Example output**

```json
{
  "match_rate": 0.5,
  "number_of_identifiers": 1000,
  "number_of_matches": 500,
  "segment_id": "1001"
}
```

### Get creative

Get one creative with its format, status, images or tags and landing page.

**Inputs**

- Creative (`creative_id`, text, required): The creative. Pick one, or give its ID from 'List creatives' or an earlier step.

**Outputs**

- `creative` (object): The creative

**Example output**

```json
{
  "creative": {
    "adaptiveAttributes": null,
    "advertiserId": "51",
    "author": "r.deckard",
    "datasetId": "49",
    "description": "Description of the creative",
    "dynamicAttributes": null,
    "format": "Image",
    "htmlTagAttributes": null,
    "id": "18",
    "imageAttributes": {
      "landingPageUrl": "https://my-landing-page.com",
      "urls": [
        "https://static.criteo.net/image_1.jpg"
      ]
    },
    "name": "My image",
    "showcaseAttributes": null,
    "status": "Live",
    "vastTagAttributes": null
  }
}
```

### Get statistics report

Report on campaign performance (spend, impressions, clicks, sales, revenue and more) between two dates, broken down by day, campaign, ad set or other dimensions. One row per combination, with totals.

**Inputs**

- Advertisers (`advertiser_ids`, list, required): The advertisers to report on.
- From (`start_date`, date, required): The first day to include.
- To (`end_date`, date, required): The last day to include.
- Break down by (`dimensions`, list, required): One row per combination of these. Picking an ID such as Campaign adds its name too. One or more of: `Day`, `Hour`, `Week`, `Month`, `Year`, `AdvertiserId` (Advertiser), `CampaignId` (Campaign), `AdsetId` (Ad set), `AdId` (Ad), `CouponId` (Coupon), and 6 more.
- Metrics (`metrics`, list, required): What to measure. Fewer than 40 keeps it quick. One or more of: `Displays` (Impressions), `Clicks`, `AdvertiserCost` (Spend), `ClickThroughRate` (Click-through rate), `Cpc` (Cost per click), `ECpm` (Cost per thousand impressions), `SalesPc30dPv24h` (Sales (30-day click, 1-day view)), `SalesPc7d` (Sales (7-day click)), `SalesClientAttribution` (Sales (your own attribution)), `RevenueGeneratedPc30dPv24h` (Revenue (30-day click, 1-day view)), and 24 more.
- Currency (`currency`, text, required): The currency amounts are reported in. One of: `EUR`, `USD`, `GBP`, `CHF`, `JPY`, `BGN`, `CZK`, `DKK`, `HUF`, `LTL`, and 99 more.
- Time zone (`time_zone`, text): The time zone days are counted in, such as Europe/Paris. Defaults to UTC.
- Ad sets (`ad_set_ids`, list): Only these ad sets. Leave empty for every ad set.

**Outputs**

- `columns` (list): The column names, in Criteo's order
- `currency` (text): The currency
- `end_date` (text): The last day
- `row_count` (number): How many rows
- `rows` (list): One row per combination, keyed by Criteo's column names (Day, CampaignId, Campaign, Clicks, AdvertiserCost...)
- `start_date` (text): The first day
- `totals` (object): Each metric added up over every row

**Example output**

```json
{
  "columns": [
    "Day",
    "Currency",
    "Displays",
    "Clicks",
    "AdvertiserCost"
  ],
  "currency": "USD",
  "end_date": "2026-11-11",
  "row_count": 2,
  "rows": [
    {
      "AdvertiserCost": 41.2,
      "Clicks": 35,
      "Currency": "USD",
      "Day": "2026/11/10",
      "Displays": 2534
    },
    {
      "AdvertiserCost": 102.75,
      "Clicks": 96,
      "Currency": "USD",
      "Day": "2026/11/11",
      "Displays": 6234
    }
  ],
  "start_date": "2026-11-10",
  "totals": {
    "AdvertiserCost": 143.95,
    "Clicks": 131,
    "Displays": 8768
  }
}
```

### List ads

List an advertiser's ads with the creative and ad set each joins, its dates and whether it is live. Gets one page; to see more, run it again skipping the ones you have.

**Inputs**

- Advertiser (`advertiser_id`, text, required): The advertiser. Pick one, or give its ID from an earlier step.
- Page size (`limit`, number): How many to return, 1 to 100. Criteo's default is 50. From 1 to 100.
- Skip (`offset`, number): How many to skip, to read the next page (for example 50). At least 0.

**Outputs**

- `ads` (list): The ads
- `count` (number): How many came back

**Example output**

```json
{
  "ads": [
    {
      "adDeliveryStatus": "Live",
      "adSetId": "345",
      "creativeId": "18",
      "description": "Description of my first ad",
      "endDate": "2026-10-08T08:47:30.000Z",
      "id": "15",
      "inventoryType": "Display",
      "name": "My first ad",
      "startDate": "2026-09-08T08:47:30.000Z"
    }
  ],
  "count": 1
}
```

### List advertisers

List the advertisers that have approved this connection's app, with their IDs and names.

**Inputs**: None.

**Outputs**

- `advertisers` (list): The advertisers
- `count` (number): How many came back

**Example output**

```json
{
  "advertisers": [
    {
      "id": "12345",
      "name": "Acme Shoes"
    }
  ],
  "count": 1
}
```

### List creatives

List an advertiser's creatives (the artwork ads show) with their format and status. Gets one page; to see more, run it again skipping the ones you have.

**Inputs**

- Advertiser (`advertiser_id`, text, required): The advertiser. Pick one, or give its ID from an earlier step.
- Page size (`limit`, number): How many to return, 1 to 100. Criteo's default is 50. From 1 to 100.
- Skip (`offset`, number): How many to skip, to read the next page (for example 50). At least 0.

**Outputs**

- `count` (number): How many came back
- `creatives` (list): The creatives

**Example output**

```json
{
  "count": 1,
  "creatives": [
    {
      "adaptiveAttributes": null,
      "advertiserId": "51",
      "author": "r.deckard",
      "datasetId": "49",
      "description": "Description of the creative",
      "dynamicAttributes": null,
      "format": "Image",
      "htmlTagAttributes": null,
      "id": "18",
      "imageAttributes": {
        "landingPageUrl": "https://my-landing-page.com",
        "urls": [
          "https://static.criteo.net/image_1.jpg"
        ]
      },
      "name": "My image",
      "showcaseAttributes": null,
      "status": "Live",
      "vastTagAttributes": null
    }
  ]
}
```

### Remove people from contact list

Take people off a contact list by email, phone number or another identifier.

**Inputs**

- Contact list (`segment_id`, text, required): The contact list segment. Pick one, or give its ID from 'Create contact list' or an earlier step.
- Identifier type (`identifier_type`, text): What the people are given as. Emails may be plain or hashed (MD5, SHA-256); phone numbers need their country code, like +33... Defaults to email. One of: `email` (Email address (plain or hashed)), `phoneNumber` (Phone number), `madid` (Mobile advertising ID), `identityLink` (LiveRamp IdentityLink), `gum` (Criteo GUM ID). Default: `email`.
- People (`identifiers`, list, required): The identifiers, all of the type chosen, up to 50,000.
- GUM caller ID (`gum_caller_id`, text): Only for GUM IDs: the caller ID your Criteo account team gave you. Only when Identifier type is Criteo GUM ID.

**Outputs**

- `identifier_type` (text): The identifier type
- `invalid_count` (number): How many it couldn't read
- `operation` (text): add or remove
- `requested_at` (text): When Criteo took the change
- `sample_invalid` (list): Some of those it couldn't read
- `segment_id` (text): The contact list
- `valid_count` (number): How many identifiers Criteo accepted

**Example output**

```json
{
  "identifier_type": "email",
  "invalid_count": 0,
  "operation": "remove",
  "requested_at": "2026-12-10T10:00:50.000Z",
  "sample_invalid": [],
  "segment_id": "1001",
  "valid_count": 2
}
```

### Search ad sets

List ad sets with their status, schedule, bid, budget and targeting, for some advertisers, campaigns or ad sets, or every one the app can reach.

**Inputs**

- Advertisers (`advertiser_ids`, list): Only these advertisers. Leave empty for every advertiser.
- Campaigns (`campaign_ids`, list): Only these campaigns. Leave empty for every campaign.
- Ad sets (`ad_set_ids`, list): Only these ad sets. Leave empty for every ad set.

**Outputs**

- `ad_sets` (list): The ad sets
- `count` (number): How many came back

**Example output**

```json
{
  "ad_sets": [
    {
      "adSetType": "standard",
      "advertiserId": "12345",
      "attributionConfiguration": {
        "attributionMethod": "criteoAttribution",
        "lookbackWindow": null
      },
      "bidding": {
        "bidAmount": 0.9,
        "costController": "maxCPC"
      },
      "budget": {
        "budgetAmount": 123.45,
        "budgetDeliverySmoothing": "standard",
        "budgetDeliveryWeek": "mondayToSunday",
        "budgetRenewal": "weekly",
        "budgetStrategy": "capped",
        "pacingBehavior": "targetFullBudget"
      },
      "campaignId": "99999",
      "datasetId": "6789",
      "destinationEnvironment": "web",
      "id": "123467",
      "mediaType": "display",
      "name": "Campaign A",
      "objective": "conversions",
      "schedule": {
        "activationStatus": "on",
        "deliveryStatus": "live",
        "endDate": {
          "value": null
        },
        "startDate": {
          "value": "2026-11-13T00:00:00Z"
        }
      },
      "scheduledBudgets": [],
      "targeting": {
        "deliveryLimitations": {
          "devices": [
            "mobile",
            "tablet",
            "desktop"
          ]
        },
        "frequencyCapping": {
          "frequency": "hourly",
          "maximumImpressions": 3
        },
        "geoLocation": {
          "countries": {
            "operand": "in",
            "values": [
              "FR"
            ]
          }
        }
      },
      "videoChannel": null
    }
  ],
  "count": 1
}
```

### Search audience segments

List audience segments (the groups of people audiences are built from), by advertiser, type or ID. Gets one page; to see more, run it again skipping the ones you have.

**Inputs**

- Advertisers (`advertiser_ids`, list): Only these advertisers. Leave empty for every advertiser.
- Segment types (`segment_types`, list): Only segments of these types. Leave empty for all. One or more of: `ContactList` (Contact list), `Retargeting`, `Lookalike`, `Prospecting`, `InMarket` (In-market), `Location`, `Behavioral` (Behavioral (made by Criteo)).
- Segment IDs (`segment_ids`, list): Only these segments, by ID.
- Page size (`limit`, number): How many to return, 1 to 100. Criteo's default is 50. From 1 to 100.
- Skip (`offset`, number): How many to skip, to read the next page (for example 50). At least 0.

**Outputs**

- `count` (number): How many came back
- `offset` (number): How many were skipped
- `segments` (list): The segments
- `total` (number): How many match in all

**Example output**

```json
{
  "count": 1,
  "offset": 0,
  "segments": [
    {
      "advertiserId": "4949",
      "contactList": {
        "isReadOnly": false
      },
      "createdAt": "2026-05-09T16:30:50.4633333",
      "description": "Contact list description",
      "id": "1001",
      "name": "My contact list segment",
      "type": "ContactList",
      "updatedAt": null
    }
  ],
  "total": 1
}
```

### Search audiences

List audiences with the ad sets that target them, by advertiser, audience, ad set or segment. Gets one page; to see more, run it again skipping the ones you have.

**Inputs**

- Advertisers (`advertiser_ids`, list): Only these advertisers. Leave empty for every advertiser.
- Audiences (`audience_ids`, list): Only these audiences. Leave empty for all.
- Ad sets (`ad_set_ids`, list): Only these ad sets. Leave empty for every ad set.
- Segment IDs (`segment_ids`, list): Only audiences built from these segments, by ID.
- Page size (`limit`, number): How many to return, 1 to 100. Criteo's default is 50. From 1 to 100.
- Skip (`offset`, number): How many to skip, to read the next page (for example 50). At least 0.

**Outputs**

- `audiences` (list): The audiences
- `count` (number): How many came back
- `offset` (number): How many were skipped
- `total` (number): How many match in all

**Example output**

```json
{
  "audiences": [
    {
      "adSetIds": [
        "49122"
      ],
      "advertiserId": "4949",
      "algebra": {
        "and": [
          {
            "or": [
              {
                "audienceSegmentId": "42914"
              },
              {
                "audienceSegmentId": "19234"
              }
            ]
          },
          {
            "not": {
              "audienceSegmentId": "3482"
            }
          }
        ]
      },
      "createdAt": "2026-07-04T00:00:00Z",
      "description": "An audience which targets people of interest",
      "id": "1001",
      "name": "My audience",
      "updatedAt": null
    }
  ],
  "count": 1,
  "offset": 0,
  "total": 1
}
```

### Search campaigns

List campaigns with their goal and spend limit, for some advertisers or campaigns, or every one the app can reach.

**Inputs**

- Advertisers (`advertiser_ids`, list): Only these advertisers. Leave empty for every advertiser.
- Campaigns (`campaign_ids`, list): Only these campaigns. Leave empty for every campaign.

**Outputs**

- `campaigns` (list): The campaigns
- `count` (number): How many came back

**Example output**

```json
{
  "campaigns": [
    {
      "advertiserId": "12345",
      "budgetAutomation": {
        "automatedBudgetConfiguration": null,
        "enabled": false
      },
      "goal": "retention",
      "id": "99999",
      "name": "My Campaign",
      "scheduledSpendLimits": [],
      "sellerId": null,
      "spendLimit": {
        "spendLimitAmount": {
          "value": 123.45
        },
        "spendLimitRenewal": "daily",
        "spendLimitType": "capped"
      }
    }
  ],
  "count": 1
}
```

### Set campaign spend limit

Cap what a campaign may spend each day, each month or over its lifetime, or remove the cap. Returns the campaign as it now is.

**Inputs**

- Campaign (`campaign_id`, text, required): The campaign. Pick one, or give its ID from an earlier step.
- Spend limit (`spend_limit_type`, text, required): Capped at an amount, or no limit. One of: `capped`, `uncapped` (No limit).
- Spend limit amount (`spend_limit_amount`, number): The most it may spend, in the advertiser's currency. Needed when capped. Only when Spend limit is Capped. At least 0.01.
- Renews (`spend_limit_renewal`, text): When the amount starts again. Needed when capped. Only when Spend limit is Capped. One of: `daily` (Each day), `monthly` (Each month), `lifetime` (Over the campaign's lifetime).

**Outputs**

- `campaign` (object): The campaign
- `spend_limit_amount` (number): The spend limit in the advertiser's currency, empty if none
- `spend_limit_renewal` (text): daily, monthly or lifetime; undefined if no limit
- `spend_limit_type` (text): capped or uncapped
- `warnings` (list): Criteo's warnings about the change, if any

**Example output**

```json
{
  "campaign": {
    "advertiserId": "12345",
    "budgetAutomation": {
      "automatedBudgetConfiguration": null,
      "enabled": false
    },
    "goal": "retention",
    "id": "99999",
    "name": "My Campaign",
    "scheduledSpendLimits": [],
    "sellerId": null,
    "spendLimit": {
      "spendLimitAmount": {
        "value": 123.45
      },
      "spendLimitRenewal": "daily",
      "spendLimitType": "capped"
    }
  },
  "spend_limit_amount": 123.45,
  "spend_limit_renewal": "daily",
  "spend_limit_type": "capped",
  "warnings": []
}
```

### Start ad set

Turn an ad set on, so it delivers (and spends) within its schedule and budget. Nothing changes if it is already on.

**Inputs**

- Ad set (`ad_set_id`, text, required): The ad set. Pick one, or give its ID from an earlier step.

**Outputs**

- `ad_set_id` (text): The ad set
- `started` (true/false): True once Criteo took it
- `warnings` (list): Criteo's warnings about the change, if any

**Example output**

```json
{
  "ad_set_id": "123467",
  "started": true,
  "warnings": []
}
```

### Stop ad set

Turn an ad set off, so it stops delivering and spending. Nothing changes if it is already off.

**Inputs**

- Ad set (`ad_set_id`, text, required): The ad set. Pick one, or give its ID from an earlier step.

**Outputs**

- `ad_set_id` (text): The ad set
- `stopped` (true/false): True once Criteo took it
- `warnings` (list): Criteo's warnings about the change, if any

**Example output**

```json
{
  "ad_set_id": "123467",
  "stopped": true,
  "warnings": []
}
```

### Target ad set at audience

Make an ad set show its ads to an audience (built from segments with 'Create audience'), in place of the one it targets now.

**Inputs**

- Ad set (`ad_set_id`, text, required): The ad set. Pick one, or give its ID from an earlier step.
- Audience (`audience_id`, text, required): The audience. Pick one, or give its ID from an earlier step.

**Outputs**

- `ad_set_id` (text): The ad set
- `audience_id` (text): The audience it targets

**Example output**

```json
{
  "ad_set_id": "123467",
  "audience_id": "9876"
}
```

### Update ad set

Change an ad set's name, bid, budget, start or end. Only the fields you fill in change. Returns the ad set as it now is.

**Inputs**

- Ad set (`ad_set_id`, text, required): The ad set. Pick one, or give its ID from an earlier step.
- Name (`name`, text): A new name. Leave empty to keep it.
- Bid amount (`bid_amount`, number): The new bid or target for the ad set's objective, in the advertiser's currency (up to 4 decimals). At least 0.0001.
- Budget (`budget_strategy`, text): Capped at an amount, or no limit. Leave empty to keep it. One of: `capped`, `uncapped` (No limit).
- Budget amount (`budget_amount`, number): The most it may spend each period, in the advertiser's currency. At least 0.01.
- Budget renews (`budget_renewal`, text): When the budget starts again. One of: `daily` (Each day), `weekly` (Each week), `monthly` (Each month), `lifetime` (Over the ad set's lifetime).
- Pacing (`budget_delivery_smoothing`, text): How the budget is spent across each period. One of: `standard` (Spread evenly), `accelerated` (Spend as fast as it delivers well).
- Start (`start_date`, date and time): When the ad set starts delivering.
- End (`end_date`, date and time): When the ad set stops delivering.

**Outputs**

- `activation_status` (text): on or off: whether it is set to deliver
- `ad_set` (object): The ad set
- `budget_amount` (number): The budget in the advertiser's currency, empty if no limit
- `delivery_status` (text): Whether it delivers, such as live, paused, scheduled or ended
- `warnings` (list): Criteo's warnings about the change, if any

**Example output**

```json
{
  "activation_status": "on",
  "ad_set": {
    "adSetType": "standard",
    "advertiserId": "12345",
    "attributionConfiguration": {
      "attributionMethod": "criteoAttribution",
      "lookbackWindow": null
    },
    "bidding": {
      "bidAmount": 0.9,
      "costController": "maxCPC"
    },
    "budget": {
      "budgetAmount": 123.45,
      "budgetDeliverySmoothing": "standard",
      "budgetDeliveryWeek": "mondayToSunday",
      "budgetRenewal": "weekly",
      "budgetStrategy": "capped",
      "pacingBehavior": "targetFullBudget"
    },
    "campaignId": "99999",
    "datasetId": "6789",
    "destinationEnvironment": "web",
    "id": "123467",
    "mediaType": "display",
    "name": "Campaign A",
    "objective": "conversions",
    "schedule": {
      "activationStatus": "on",
      "deliveryStatus": "live",
      "endDate": {
        "value": null
      },
      "startDate": {
        "value": "2026-11-13T00:00:00Z"
      }
    },
    "scheduledBudgets": [],
    "targeting": {
      "deliveryLimitations": {
        "devices": [
          "mobile",
          "tablet",
          "desktop"
        ]
      },
      "frequencyCapping": {
        "frequency": "hourly",
        "maximumImpressions": 3
      },
      "geoLocation": {
        "countries": {
          "operand": "in",
          "values": [
            "FR"
          ]
        }
      }
    },
    "videoChannel": null
  },
  "budget_amount": 123.45,
  "delivery_status": "live",
  "warnings": []
}
```

### Update audience segment

Rename an audience segment or change its description.

**Inputs**

- Segment (`segment_id`, text, required): The audience segment's ID, from 'Search audience segments' or an earlier step. Contact lists are offered to pick from.
- Name (`name`, text): A new name. Leave empty to keep it.
- Description (`description`, text): A new description. Leave empty to keep it.

**Outputs**

- `segment` (object): The segment

**Example output**

```json
{
  "segment": {
    "advertiserId": "4949",
    "contactList": {
      "isReadOnly": false
    },
    "createdAt": "2026-05-09T16:30:50.4633333",
    "description": "Contact list description",
    "id": "1001",
    "name": "My contact list segment (v2)",
    "type": "ContactList",
    "updatedAt": null
  }
}
```
