> ## 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-01/marketing-solutions/advertisers/{advertiser-id}/coupons > Create a Coupon ## OpenAPI ````yaml https://api.criteo.com/2025-01/marketingsolutions/open-api-specifications.json post /2025-01/marketing-solutions/advertisers/{advertiser-id}/coupons openapi: 3.0.1 info: title: Criteo API description: Criteo API - MarketingSolutions version: 2025-01 servers: - url: https://api.criteo.com security: - oauth: [] tags: - name: Advertiser - name: Analytics - name: Audience - name: Campaign - name: Creative - name: Gateway paths: /2025-01/marketing-solutions/advertisers/{advertiser-id}/coupons: post: tags: - Creative summary: /2025-01/marketing-solutions/advertisers/{advertiser-id}/coupons description: Create a Coupon operationId: CreateAdvertiserCoupon parameters: - name: advertiser-id in: path description: The advertiser identifier. required: true schema: type: string requestBody: 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 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\r\nString must be in ISO8601 format" nullable: true format: enum: - FullFrame - LogoZone type: string description: >- Format of the Coupon, it can have two values: "FullFrame" or "LogoZone" 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\r\nString must be in ISO8601 format" 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 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\r\nString must be in ISO8601 format" nullable: true format: type: string description: >- Format of the Coupon, it can have two values: "FullFrame" or "LogoZone" nullable: true id: type: string description: Unique identifier (duplicate of the parent id). 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" 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: {} authorizationCode: authorizationUrl: https://api.criteo.com/oauth2 tokenUrl: https://api.criteo.com/oauth2/token scopes: {} ````