---
title: "/2026-01/marketing-solutions/advertisers/{advertiser-id}/coupons"
method: POST
path: "/2026-01/marketing-solutions/advertisers/{advertiser-id}/coupons"
tags: ["Creative"]
---

# /2026-01/marketing-solutions/advertisers/{advertiser-id}/coupons

`POST /2026-01/marketing-solutions/advertisers/{advertiser-id}/coupons`

Create a Coupon

## Path parameters

- `advertiser-id` string, required

## Request body

- ResourceInputOfCreateCoupon — A top-level object that encapsulates a Criteo API request for a single entity.
  - `data` ResourceOfCreateCoupon — A class that represents a domain entity exposed by an API.
    - `attributes` CreateCoupon — Entity to create a Coupon
      - `adSetId` string, required — The id of the Ad Set on which the Coupon is applied to
      - `description` string, nullable — The description of the Coupon
      - `endDate` string, nullable — The date when when we will stop to show this Coupon. If the end date is not specified (i.e. null) then the Coupon will go on forever String must be in ISO8601 format
      - `format` 'FullFrame' | 'LogoZone', required — Format of the Coupon, it can have two values: "FullFrame" or "LogoZone"
      - `images` CreateImageSlide[], required — List of slides containing the images as a base-64 encoded string
        - `height` integer — Height of the Coupon slide
        - `slideBase64Strings` string[], nullable — Array of images of the same size as a base-64 encoded string
        - `width` integer — Width of the Coupon slide
      - `landingPageUrl` string, required — Web redirection of the landing page url
      - `name` string, required — The name of the Coupon
      - `rotationsNumber` integer, required — Number of rotations for the Coupons (from 1 to 10 times)
      - `showDuration` integer, required — Show Coupon for a duration of N seconds (between 1 and 5)
      - `showEvery` integer, required — Show the Coupon every N seconds (between 1 and 10)
      - `startDate` string, required — The date when the coupon will be launched String must be in ISO8601 format
    - `id` string, nullable — Unique identifier of this resource.
    - `type` string, nullable

## Response `201`

The created Coupon is returned.

- ResourceOutcomeOfCoupon — A top-level object that encapsulates a Criteo API response for a single entity.
  - `data` ResourceOfCoupon, nullable — A class that represents a domain entity exposed by an API.
    - `attributes` Coupon, nullable — Coupons are static images applied on ad set which can be displayed within an ad and link to a landing page.
      - `adSetId` string, nullable — The id of the Ad Set on which the Coupon is applied to
      - `advertiserId` string, nullable — Advertiser linked to the Coupon
      - `author` string, nullable — The login of the person who created this Coupon
      - `description` string, nullable — The description of the Coupon
      - `endDate` string, nullable — The date when when we will stop to show this Coupon. If the end date is not specified (i.e. null) then the Coupon will go on forever String must be in ISO8601 format
      - `format` string, nullable — Format of the Coupon, it can have two values: "FullFrame" or "LogoZone"
      - `id` string, nullable — Unique identifier (duplicate of the parent id).
      - `images` ImageSlide[], nullable — List of slides containing the image URLs
        - `height` integer, nullable — Height of the Coupon slide
        - `slideUrls` string[], nullable — Array of images of the same size uploaded on demostatic.criteo.com when deploying and then static.criteo.net
        - `width` integer, nullable — Width of the Coupon slide
      - `landingPageUrl` string, nullable — Web redirection of the landing page url
      - `name` string, nullable — The name of the Coupon
      - `rotationsNumber` integer, nullable — Number of rotations for the Coupons (from 1 to 10 times)
      - `showDuration` integer, nullable — Show Coupon for a duration of N seconds (between 1 and 5)
      - `showEvery` integer, nullable — Show the Coupon every N seconds (between 1 and 10)
      - `startDate` string, nullable — The date when the Coupon will be launched String must be in ISO8601 format
      - `status` string, nullable — The status of the Coupon
    - `id` string, nullable — Unique identifier of this resource.
    - `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/revisions/c1721589426a/schema)