> ## Documentation Index
> Fetch the complete documentation index at: https://developers.criteo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# /2025-10/marketing-solutions/advertisers/{advertiser-id}/coupons

> Creates a coupon on one ad set of the advertiser. The ad set must already carry dynamic display or
HTML ads, and each slide image must match a size that ad set supports, which the supported-sizes
operation lists. Returns the new coupon and its id.



## OpenAPI

````yaml https://api.criteo.com/2025-10/marketingsolutions/open-api-specifications.json post /2025-10/marketing-solutions/advertisers/{advertiser-id}/coupons
openapi: 3.0.1
info:
  title: Criteo API
  description: Criteo API - MarketingSolutions
  version: 2025-10
servers:
  - url: https://api.criteo.com
security:
  - oauth: []
tags:
  - name: Advertiser
  - name: Analytics
  - name: Audience
  - name: Campaign
  - name: Creative
  - name: Gateway
  - name: Reco
paths:
  /2025-10/marketing-solutions/advertisers/{advertiser-id}/coupons:
    post:
      tags:
        - Creative
      summary: /2025-10/marketing-solutions/advertisers/{advertiser-id}/coupons
      description: "Creates a coupon on one ad set of the advertiser. The ad set must already carry dynamic display or\r\nHTML ads, and each slide image must match a size that ad set supports, which the supported-sizes\r\noperation lists. Returns the new coupon and its id."
      operationId: CreateAdvertiserCoupon
      parameters:
        - name: advertiser-id
          in: path
          description: The advertiser identifier.
          required: true
          schema:
            type: string
      requestBody:
        description: The coupon to create.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ResourceInputOfCreateCoupon'
        required: true
        x-bodyName: request
      responses:
        '201':
          description: The created Coupon is returned.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResourceOutcomeOfCoupon'
      security:
        - oauth:
            - MarketingSolutions_Creative_Manage
components:
  schemas:
    ResourceInputOfCreateCoupon:
      type: object
      properties:
        data:
          $ref: '#/components/schemas/ResourceOfCreateCoupon'
      description: >-
        A top-level object that encapsulates a Criteo API request for a single
        entity.
    ResourceOutcomeOfCoupon:
      type: object
      properties:
        data:
          $ref: '#/components/schemas/ResourceOfCoupon'
        errors:
          type: array
          items:
            $ref: '#/components/schemas/CommonProblem'
          nullable: true
          readOnly: true
        warnings:
          type: array
          items:
            $ref: '#/components/schemas/CommonProblem'
          nullable: true
          readOnly: true
      description: >-
        A top-level object that encapsulates a Criteo API response for a single
        entity.
    ResourceOfCreateCoupon:
      type: object
      properties:
        attributes:
          $ref: '#/components/schemas/CreateCoupon'
        id:
          type: string
          description: Unique identifier of this resource.
          nullable: true
        type:
          type: string
          nullable: true
      description: A class that represents a domain entity exposed by an API.
    ResourceOfCoupon:
      type: object
      properties:
        attributes:
          $ref: '#/components/schemas/Coupon'
        id:
          type: string
          description: Unique identifier of this resource.
          nullable: true
        type:
          type: string
          nullable: true
      description: A class that represents a domain entity exposed by an API.
      nullable: true
    CommonProblem:
      type: object
      properties:
        code:
          type: string
          description: A machine-readable error code, expressed as a string value.
          nullable: true
        detail:
          type: string
          description: >-
            A human-readable explanation specific to this occurrence of the
            problem
          nullable: true
        instance:
          type: string
          description: A URI that identifies the specific occurrence of the problem.
          nullable: true
        source:
          type: object
          additionalProperties:
            type: string
          description: >-
            A machine-readable structure to reference to the exact location(s)
            causing the error(s)
          nullable: true
        stackTrace:
          type: string
          nullable: true
        title:
          type: string
          description: A short human-readable description of the problem type
          nullable: true
        traceId:
          type: string
          description: The request correlation ID this problem comes from.
          nullable: true
        traceIdentifier:
          type: string
          description: >-
            The request correlation ID this problem comes from. (deprecated, use
            traceId instead)
          nullable: true
        type:
          enum:
            - unknown
            - access-control
            - authentication
            - authorization
            - availability
            - deprecation
            - quota
            - validation
          type: string
          description: The problem's category.
          nullable: true
      description: Common problem object.
    CreateCoupon:
      required:
        - adSetId
        - format
        - images
        - landingPageUrl
        - name
        - rotationsNumber
        - showDuration
        - showEvery
        - startDate
      type: object
      properties:
        adSetId:
          type: string
          description: The id of the Ad Set on which the Coupon is applied to
        description:
          type: string
          description: The description of the Coupon
          nullable: true
        endDate:
          type: string
          description: "The date when we will stop showing this coupon, which must come after the start date. If the\r\nend date is not specified (i.e. null) then the coupon will go on forever.\r\nString must be in ISO8601 format, more precisely \"yyyy-MM-ddTHH:mm:ss.fffZ\": a UTC timestamp whose\r\nthree millisecond digits and trailing \"Z\" are both required, for example \"2026-10-01T09:00:00.000Z\".\r\nNo other ISO8601 layout is accepted, neither a UTC offset such as \"2026-10-01T11:00:00+02:00\" nor a\r\nsecond-precision \"2026-10-01T09:00:00Z\".\r\nA date that does not fall on a whole hour is rounded up to the next one, so\r\n\"2026-10-01T09:30:00.000Z\" is stored as \"2026-10-01T10:00:00.000Z\"."
          nullable: true
        format:
          enum:
            - FullFrame
            - LogoZone
          type: string
          description: >-
            Format of the Coupon, it can have two values: "FullFrame" or
            "LogoZone"
        id:
          type: string
          nullable: true
        images:
          type: array
          items:
            $ref: '#/components/schemas/CreateImageSlide'
          description: List of slides containing the images as a base-64 encoded string
        landingPageUrl:
          type: string
          description: Web redirection of the landing page url
        name:
          type: string
          description: The name of the Coupon
        rotationsNumber:
          maximum: 10
          minimum: 1
          type: integer
          description: Number of rotations for the Coupons (from 1 to 10 times)
          format: int32
        showDuration:
          maximum: 5
          minimum: 1
          type: integer
          description: Show Coupon for a duration of N seconds (between 1 and 5)
          format: int32
        showEvery:
          maximum: 10
          minimum: 1
          type: integer
          description: Show the Coupon every N seconds (between 1 and 10)
          format: int32
        startDate:
          type: string
          description: "The date when the coupon will be launched. It must be a date in the future.\r\nString must be in ISO8601 format, more precisely \"yyyy-MM-ddTHH:mm:ss.fffZ\": a UTC timestamp whose\r\nthree millisecond digits and trailing \"Z\" are both required, for example \"2026-10-01T09:00:00.000Z\".\r\nNo other ISO8601 layout is accepted, neither a UTC offset such as \"2026-10-01T11:00:00+02:00\" nor a\r\nsecond-precision \"2026-10-01T09:00:00Z\".\r\nA date that does not fall on a whole hour is rounded up to the next one, so\r\n\"2026-10-01T09:30:00.000Z\" is stored as \"2026-10-01T10:00:00.000Z\"."
      description: Entity to create a Coupon
    Coupon:
      type: object
      properties:
        adSetId:
          type: string
          description: The id of the Ad Set on which the Coupon is applied to
          nullable: true
        advertiserId:
          type: string
          description: Advertiser linked to the Coupon
          nullable: true
        author:
          type: string
          description: The login of the person who created this Coupon
          nullable: true
        description:
          type: string
          description: The description of the Coupon
          nullable: true
        endDate:
          type: string
          description: "The date when we will stop showing this coupon. If the end date is not specified (i.e. null)\r\nthen the coupon will go on forever.\r\nString must be in ISO8601 format, more precisely \"yyyy-MM-ddTHH:mm:ss.fffZ\": a UTC timestamp whose\r\nthree millisecond digits and trailing \"Z\" are always present, for example \"2026-10-01T09:00:00.000Z\"."
          nullable: true
        format:
          type: string
          description: >-
            Format of the Coupon, it can have two values: "FullFrame" or
            "LogoZone"
          nullable: true
        id:
          type: string
          nullable: true
        images:
          type: array
          items:
            $ref: '#/components/schemas/ImageSlide'
          description: List of slides containing the image URLs
          nullable: true
        landingPageUrl:
          type: string
          description: Web redirection of the landing page url
          nullable: true
        name:
          type: string
          description: The name of the Coupon
          nullable: true
        rotationsNumber:
          type: integer
          description: Number of rotations for the Coupons (from 1 to 10 times)
          format: int32
          nullable: true
        showDuration:
          type: integer
          description: Show Coupon for a duration of N seconds (between 1 and 5)
          format: int32
          nullable: true
        showEvery:
          type: integer
          description: Show the Coupon every N seconds (between 1 and 10)
          format: int32
          nullable: true
        startDate:
          type: string
          description: "The date when the coupon will be launched.\r\nString must be in ISO8601 format, more precisely \"yyyy-MM-ddTHH:mm:ss.fffZ\": a UTC timestamp whose\r\nthree millisecond digits and trailing \"Z\" are always present, for example \"2026-10-01T09:00:00.000Z\"."
          nullable: true
        status:
          type: string
          description: The status of the Coupon
          nullable: true
      description: >-
        Coupons are static images applied on ad set which can be displayed
        within an ad and link to a landing page.
      nullable: true
    CreateImageSlide:
      type: object
      properties:
        height:
          type: integer
          description: Height of the Coupon slide
          format: int32
        slideBase64Strings:
          type: array
          items:
            type: string
          description: Array of images of the same size as a base-64 encoded string
          nullable: true
        width:
          type: integer
          description: Width of the Coupon slide
          format: int32
      description: Slide containing the images of the same size as a base-64 encoded string
    ImageSlide:
      type: object
      properties:
        height:
          type: integer
          description: Height of the Coupon slide
          format: int32
          nullable: true
        slideUrls:
          type: array
          items:
            type: string
          description: "Array of images of the same size uploaded on demostatic.criteo.com when deploying and then\_static.criteo.net"
          nullable: true
        width:
          type: integer
          description: Width of the Coupon slide
          format: int32
          nullable: true
      description: Slide containing the image URLs
  securitySchemes:
    oauth:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: https://api.criteo.com/oauth2/token
          scopes:
            MarketingSolutions_Analytics_Read: >-
              Grants Read access to the capabilities from the Analytics domain,
              for MarketingSolutions applications
            MarketingSolutions_Audience_Manage: >-
              Grants Manage access to the capabilities from the Audience domain,
              for MarketingSolutions applications
            MarketingSolutions_Audience_Read: >-
              Grants Read access to the capabilities from the Audience domain,
              for MarketingSolutions applications
            MarketingSolutions_Campaign_Manage: >-
              Grants Manage access to the capabilities from the Campaign domain,
              for MarketingSolutions applications
            MarketingSolutions_Campaign_Read: >-
              Grants Read access to the capabilities from the Campaign domain,
              for MarketingSolutions applications
            MarketingSolutions_Creative_Manage: >-
              Grants Manage access to the capabilities from the Creative domain,
              for MarketingSolutions applications
            MarketingSolutions_Creative_Read: >-
              Grants Read access to the capabilities from the Creative domain,
              for MarketingSolutions applications
            MarketingSolutions_Reco_Manage: >-
              Grants Manage access to the capabilities from the Reco domain, for
              MarketingSolutions applications
            MarketingSolutions_Reco_Read: >-
              Grants Read access to the capabilities from the Reco domain, for
              MarketingSolutions applications
        authorizationCode:
          authorizationUrl: https://api.criteo.com/oauth2
          tokenUrl: https://api.criteo.com/oauth2/token
          scopes:
            MarketingSolutions_Analytics_Read: >-
              Grants Read access to the capabilities from the Analytics domain,
              for MarketingSolutions applications
            MarketingSolutions_Audience_Manage: >-
              Grants Manage access to the capabilities from the Audience domain,
              for MarketingSolutions applications
            MarketingSolutions_Audience_Read: >-
              Grants Read access to the capabilities from the Audience domain,
              for MarketingSolutions applications
            MarketingSolutions_Campaign_Manage: >-
              Grants Manage access to the capabilities from the Campaign domain,
              for MarketingSolutions applications
            MarketingSolutions_Campaign_Read: >-
              Grants Read access to the capabilities from the Campaign domain,
              for MarketingSolutions applications
            MarketingSolutions_Creative_Manage: >-
              Grants Manage access to the capabilities from the Creative domain,
              for MarketingSolutions applications
            MarketingSolutions_Creative_Read: >-
              Grants Read access to the capabilities from the Creative domain,
              for MarketingSolutions applications
            MarketingSolutions_Reco_Manage: >-
              Grants Manage access to the capabilities from the Reco domain, for
              MarketingSolutions applications
            MarketingSolutions_Reco_Read: >-
              Grants Read access to the capabilities from the Reco domain, for
              MarketingSolutions applications

````