> ## 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/retail-media/accounts/{account-id}/creatives > Create a creative for an account ## OpenAPI ````yaml https://api.criteo.com/2025-10/retailmedia/open-api-specifications.json post /2025-10/retail-media/accounts/{account-id}/creatives openapi: 3.0.1 info: title: Criteo API description: Criteo API - RetailMedia version: 2025-10 servers: - url: https://api.criteo.com security: - oauth: [] tags: - name: Accounts - name: Analytics - name: Audience - name: Balance - name: Billing - name: Campaign - name: Gateway paths: /2025-10/retail-media/accounts/{account-id}/creatives: post: tags: - Campaign summary: /2025-10/retail-media/accounts/{account-id}/creatives description: Create a creative for an account operationId: CreateCreative parameters: - name: account-id in: path description: External account id to create a creative for required: true schema: type: string requestBody: description: The creative to create content: application/json: schema: $ref: '#/components/schemas/CreativeCreateModel202207' required: true responses: '201': description: Creatives created content: application/json: schema: $ref: '#/components/schemas/Creative202210Response' security: - oauth: - RetailMedia_Campaign_Manage components: schemas: CreativeCreateModel202207: required: - name - retailerId - templateId - templateVariableValues type: object properties: brandId: type: integer description: The brand associated to the creative format: int64 nullable: true id: type: string nullable: true name: type: string description: The name of the creative retailerId: type: integer description: The retailer associated to the creative format: int32 templateId: type: integer description: The creative template used for this creative format: int32 templateVariableValues: type: array items: $ref: '#/components/schemas/TemplateVariableValue' description: The template chosen values additionalProperties: false description: Create model of a creative Creative202210Response: type: object properties: data: $ref: '#/components/schemas/ResourceOfCreative202210' errors: type: array items: $ref: '#/components/schemas/CommonProblem' nullable: true readOnly: true warnings: type: array items: $ref: '#/components/schemas/CommonProblem' nullable: true readOnly: true additionalProperties: false description: >- A top-level object that encapsulates a Criteo API response for a single entity. TemplateVariableValue: required: - id type: object properties: choiceVariableValue: $ref: '#/components/schemas/ChoiceVariableValue' colorVariableValue: $ref: '#/components/schemas/ColorVariableValue' filesVariableValue: $ref: '#/components/schemas/FilesVariableValue' hyperlinkVariableValue: $ref: '#/components/schemas/HyperlinkVariableValue' id: type: string description: The id of the template variable the value is applied to textVariableValue: $ref: '#/components/schemas/TextVariableValue' videoVariableValue: $ref: '#/components/schemas/VideoVariableValue' additionalProperties: false description: A value for a variable in a creative template. ResourceOfCreative202210: type: object properties: attributes: $ref: '#/components/schemas/Creative202210' id: type: string description: Unique identifier of this resource. nullable: true type: type: string nullable: true additionalProperties: false 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. ChoiceVariableValue: required: - chosenOptions type: object properties: chosenOptions: type: array items: type: string description: The chosen options additionalProperties: false description: A value of a template choice variable (among different accepted options) nullable: true ColorVariableValue: required: - color type: object properties: color: pattern: ^#(([0-9a-fA-F]{2}){3}|([0-9a-fA-F]){3})$ type: string description: The displayed color (HEX format) nullable: true additionalProperties: false description: A value of a template color variable nullable: true FilesVariableValue: required: - assetIds type: object properties: assetIds: type: array items: type: string description: The assets representing the images to be displayed additionalProperties: false description: >- A value of a template file variable (one or several files), like images in a creative nullable: true HyperlinkVariableValue: required: - url type: object properties: url: type: string description: The url to redirect to nullable: true additionalProperties: false description: A value of a template hyperlink variable nullable: true TextVariableValue: required: - text type: object properties: text: type: string description: The displayed text nullable: true additionalProperties: false description: A value of a template text variable nullable: true VideoVariableValue: required: - duration - height - url - width type: object properties: duration: minLength: 1 type: string description: The video's duration height: type: integer description: The video's height format: int32 url: minLength: 1 type: string description: The vast video url width: type: integer description: The video's width format: int32 additionalProperties: false description: A value of a template video variable nullable: true Creative202210: required: - creativeFormatType - environments - formatId - name - retailerId - status - templateId - templateName - templateVariableValues type: object properties: associatedLineItemIds: type: array items: type: string description: Associated Line Item Ids nullable: true brandId: type: integer description: Brand Id format: int64 nullable: true creativeFormatType: enum: - Unknown - FlagShip - Showcase - SponsoredProducts - Butterfly - BundleBoost - IAB - CUSTOM - DisplayPanel - DigitalShelfTalker type: string description: Creative format type environments: type: array items: $ref: '#/components/schemas/PageTypeEnvironment202210' description: Environment type (e.g. mobile, web, app) formatId: type: integer description: Format Id format: int32 id: type: string nullable: true name: type: string description: Name retailerId: type: integer description: Retailer Id format: int32 status: enum: - Ready - In_Use - Archived - Deleted type: string description: Creative Status templateId: type: integer description: Template Id format: int32 templateName: type: string description: Template Name templateVariableValues: type: array items: $ref: '#/components/schemas/TemplateVariableValue' description: The template chosen values updatedAt: type: string description: Updated at time format: date-time nullable: true additionalProperties: false description: A creative entity nullable: true PageTypeEnvironment202210: type: object properties: environments: type: array items: enum: - Web - Mobile - App - Lockout - Mixed - iOS - Android type: string description: Creative format, defining where the creative can be served description: List of environments per PageType nullable: true pageType: enum: - Search - Home - Browse - Checkout - Category - ProductDetail - Confirmation - Merchandising - Deals type: string description: Creative PageType nullable: true additionalProperties: false description: The PageType-Environment Tuples for creatives 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: {} ````