> ## 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.

# /preview/advertisers/{advertiser-id}/ads

> Creates an ad by binding an existing creative to an existing ad set of the advertiser, delivering
from the start date given. The creative and the ad set must both belong to that advertiser. Returns
the new ad and its id.



## OpenAPI

````yaml https://api.criteo.com/preview/marketingsolutions/open-api-specifications.json post /preview/advertisers/{advertiser-id}/ads
openapi: 3.0.1
info:
  title: Criteo API
  description: Criteo API - MarketingSolutions
  version: Preview
servers:
  - url: https://api.criteo.com
security:
  - oauth: []
tags:
  - name: Advertiser
  - name: Analytics
  - name: Audience
  - name: Campaign
  - name: Catalog
  - name: Creative
  - name: Gateway
  - name: OnSiteRecommendation
  - name: Reco
paths:
  /preview/advertisers/{advertiser-id}/ads:
    post:
      tags:
        - Creative
      summary: /preview/advertisers/{advertiser-id}/ads
      description: "Creates an ad by binding an existing creative to an existing ad set of the advertiser, delivering\r\nfrom the start date given. The creative and the ad set must both belong to that advertiser. Returns\r\nthe new ad and its id."
      operationId: CreateAdvertiserAd
      parameters:
        - name: advertiser-id
          in: path
          description: The advertiser identifier.
          required: true
          schema:
            type: string
      requestBody:
        description: The ad information.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ResourceInputOfAdWrite'
        required: true
        x-bodyName: request
      responses:
        '201':
          description: The created Ad is returned.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResourceOutcomeOfAd'
      security:
        - oauth:
            - MarketingSolutions_Creative_Manage
components:
  schemas:
    ResourceInputOfAdWrite:
      type: object
      properties:
        data:
          $ref: '#/components/schemas/ResourceOfAdWrite'
      description: >-
        A top-level object that encapsulates a Criteo API request for a single
        entity.
    ResourceOutcomeOfAd:
      type: object
      properties:
        data:
          $ref: '#/components/schemas/ResourceOfAd'
        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.
    ResourceOfAdWrite:
      type: object
      properties:
        attributes:
          $ref: '#/components/schemas/AdWrite'
        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.
    ResourceOfAd:
      type: object
      properties:
        attributes:
          $ref: '#/components/schemas/Ad'
        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.
    AdWrite:
      required:
        - adSetId
        - creativeId
        - name
        - startDate
      type: object
      properties:
        adClickTracking:
          type: array
          items:
            $ref: '#/components/schemas/ExamAdClickTracking'
          description: Optional ad-level click tracking configuration.
          nullable: true
        adImpressionTracking:
          type: array
          items:
            $ref: '#/components/schemas/ExamAdImpressionTracking'
          description: Optional ad-level impression tracking configuration.
          nullable: true
        adSetId:
          type: string
          description: The id of the Ad Set bound to this Ad
        creativeId:
          type: string
          description: The id of the Creative bound to this Ad
        description:
          type: string
          description: The description of the ad
          nullable: true
        endDate:
          type: string
          description: "The date when we will stop showing this ad, which must come after the start date. If the end\r\ndate is not specified (i.e. null) then the ad 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:30:00.000Z\".\r\nNo other ISO8601 layout is accepted, neither a UTC offset such as \"2026-10-01T11:30:00+02:00\" nor a\r\nsecond-precision \"2026-10-01T09:30:00Z\"."
          nullable: true
        id:
          type: string
          nullable: true
        inventoryType:
          enum:
            - Native
            - Display
            - Video
            - Meta
          type: string
          description: "The inventory the Ad to be created or updated belongs to. Possible values are \"Display\", \"Native\",\r\n\"Video\" and \"Meta\". This is optional since it doesn't make sense for every creative type: it is inferred\r\nfrom the creative for a video creative, and an error is returned if it is not set for a dynamic creative.\r\n\"Meta\" additionally requires the target ad set to be linked to Meta."
          nullable: true
        name:
          type: string
          description: The name of the ad
        startDate:
          type: string
          description: "The date when the ad 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:30:00.000Z\".\r\nNo other ISO8601 layout is accepted, neither a UTC offset such as \"2026-10-01T11:30:00+02:00\" nor a\r\nsecond-precision \"2026-10-01T09:30:00Z\"."
      description: Entity to create an ad
    Ad:
      type: object
      properties:
        adClickTracking:
          type: array
          items:
            $ref: '#/components/schemas/ExamAdClickTracking'
          description: Optional ad-level click tracking configuration.
          nullable: true
        adDeliveryStatus:
          enum:
            - Live
            - Paused
          type: string
          description: "The delivery status of the ad. Possible values are \"Live\" and \"Paused\". This is read-only: use the\r\ndedicated pause and unpause operations to change it."
          nullable: true
        adImpressionTracking:
          type: array
          items:
            $ref: '#/components/schemas/ExamAdImpressionTracking'
          description: Optional ad-level impression tracking configuration.
          nullable: true
        adSetId:
          type: string
          description: The id of the Ad Set binded to this Ad
          nullable: true
        creativeId:
          type: string
          description: The id of the Creative binded to this Ad
          nullable: true
        description:
          type: string
          description: The description of the ad
          nullable: true
        endDate:
          type: string
          description: "The date when we will stop showing this ad. If the end date is not specified (i.e. null) then\r\nthe ad 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:30:00.000Z\"."
          nullable: true
        id:
          type: string
          nullable: true
        inventoryType:
          enum:
            - Native
            - Display
            - Video
            - Meta
          type: string
          description: "The inventory the Ad belongs to. Possible values are \"Display\", \"Native\", \"Video\" and \"Meta\". This is\r\noptional since it doesn't make sense for every creative type: it is inferred from the creative for a\r\nvideo creative, and an error is returned if it is not set for a dynamic creative."
          nullable: true
        name:
          type: string
          description: The name of the ad
          nullable: true
        startDate:
          type: string
          description: "The date when the ad 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:30:00.000Z\"."
          nullable: true
      description: An ad is the binding that connects a creative with an ad set
      nullable: true
    ExamAdClickTracking:
      type: object
      properties:
        bindingId:
          type: string
          description: "Unique ID of the ad the rule belongs to. It always names the ad of the request path, so it can be left\r\nout of a write; when it is sent it must match that ad, and a rule naming another one is refused."
          nullable: true
        clickZone:
          enum:
            - Unknown
            - AppInstall
            - Coupon
            - Logo
            - Main
            - Product
            - Store
            - Video
            - BrandingImage
          type: string
          description: "The banner zone this rule applies to. Leave it out for a rule that is not specific to a zone.\r\nPossible values are \"AppInstall\", \"Coupon\", \"Logo\", \"Main\", \"Product\", \"Store\", \"Video\" and\r\n\"BrandingImage\"."
          nullable: true
        disableForCoupons:
          type: boolean
          description: Whether this rule is skipped for clicks on coupons.
          nullable: true
        disableLandingUrlEncode:
          type: boolean
          description: >-
            Whether the landing url is left unencoded when it is substituted
            into the tracking url.
          nullable: true
        disableMacroUrlEncode:
          type: boolean
          description: >-
            Whether url macros are left unencoded when they are substituted into
            the tracking url.
          nullable: true
        displayHeight:
          type: integer
          description: "The height in pixels of the display size this rule applies to. Set it together with displayWidth, and\r\nleave both out for a rule that is not specific to a display size."
          format: int32
          nullable: true
        displayWidth:
          type: integer
          description: "The width in pixels of the display size this rule applies to. Set it together with displayHeight, and\r\nleave both out for a rule that is not specific to a display size."
          format: int32
          nullable: true
        id:
          type: string
          description: "Unique ID of the click tracking rule. Leave it out to create a rule; send back the ID of an existing\r\nrule to update it. Rules of the ad that are absent from a write request are deleted."
          nullable: true
        urlPrefix:
          type: string
          description: The url prepended to the landing url of the clicks this rule covers.
          nullable: true
        urlSuffix:
          type: string
          description: The url appended to the landing url of the clicks this rule covers.
          nullable: true
      description: "An ad-level click tracking rule. A rule wraps the landing url of the clicks it covers with a prefix and a\r\nsuffix. It applies either to the whole ad (neither clickZone nor a display size set), to one banner zone\r\n(clickZone set), or to one display size (displayWidth and displayHeight both set)."
    ExamAdImpressionTracking:
      type: object
      properties:
        bindingId:
          type: string
          description: "Unique ID of the ad the rule belongs to. It always names the ad of the request path, so it can be left\r\nout of a write; when it is sent it must match that ad, and a rule naming another one is refused."
          nullable: true
        displayHeight:
          type: integer
          description: "The height in pixels of the display size this rule applies to. Set it together with displayWidth, and\r\nleave both out for a rule that is not specific to a display size."
          format: int32
          nullable: true
        displayWidth:
          type: integer
          description: "The width in pixels of the display size this rule applies to. Set it together with displayHeight, and\r\nleave both out for a rule that is not specific to a display size."
          format: int32
          nullable: true
        id:
          type: string
          description: "Unique ID of the impression tracking rule. Leave it out to create a rule; send back the ID of an\r\nexisting rule to update it. Rules of the ad that are absent from a write request are deleted."
          nullable: true
        url:
          type: string
          description: The url called when an impression covered by this rule is served.
          nullable: true
        vendorId:
          type: string
          description: Unique ID of the third party vendor the tracking url belongs to.
          nullable: true
      description: "An ad-level impression tracking rule. The rule calls its url when an impression it covers is served. It\r\napplies either to the whole ad (no display size set) or to one display size (displayWidth and displayHeight\r\nboth set)."
  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_Catalog_Manage: >-
              Grants Manage access to the capabilities from the Catalog domain,
              for MarketingSolutions applications
            MarketingSolutions_Catalog_Read: >-
              Grants Read access to the capabilities from the Catalog 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_OnSiteRecommendation_Read: >-
              Grants Read access to the capabilities from the
              OnSiteRecommendation 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_Catalog_Manage: >-
              Grants Manage access to the capabilities from the Catalog domain,
              for MarketingSolutions applications
            MarketingSolutions_Catalog_Read: >-
              Grants Read access to the capabilities from the Catalog 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_OnSiteRecommendation_Read: >-
              Grants Read access to the capabilities from the
              OnSiteRecommendation 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

````