---
updatedAt: 2026-08-14T00:03:45.000Z
---

# Create a creative

Create a new creative using the provided payload.

# OpenAPI definition

```json
{
  "openapi": "3.0.3",
  "info": {
    "title": "Creative API Resources",
    "version": "2.0.0",
    "description": "Buzz API v2"
  },
  "paths": {
    "/creatives": {
      "post": {
        "operationId": "creatives_create",
        "description": "Create a new creative using the provided payload.",
        "summary": "Create a creative",
        "tags": [
          "Creatives"
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Creative"
              }
            },
            "application/x-www-form-urlencoded": {
              "schema": {
                "$ref": "#/components/schemas/Creative"
              }
            },
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/Creative"
              }
            }
          },
          "required": true
        },
        "security": [
          {
            "nestSessionAuth": []
          },
          {
            "nestBasicAuth": []
          }
        ],
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Creative"
                }
              }
            },
            "description": "Creative created successfully."
          },
          "400": {
            "description": "Invalid or incomplete data."
          },
          "401": {
            "description": "Unauthorized."
          },
          "403": {
            "description": "Permission denied."
          },
          "500": {
            "description": "Unexpected error occurred during creation."
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Creative": {
        "type": "object",
        "properties": {
          "strict_validation": {
            "type": "boolean",
            "writeOnly": true,
            "default": true
          },
          "id": {
            "type": "integer",
            "readOnly": true
          },
          "create_date": {
            "type": "string",
            "readOnly": true,
            "nullable": true,
            "description": "The date and time the object was first created",
            "pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$",
            "example": "2025-09-29 00:00:00"
          },
          "update_date": {
            "type": "string",
            "readOnly": true,
            "nullable": true,
            "description": "The date and time the object was last updated",
            "pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$",
            "example": "2025-09-29 00:00:00"
          },
          "account_id": {
            "type": "integer",
            "description": "Defaults to the account in the active session"
          },
          "active": {
            "type": "boolean",
            "default": true
          },
          "name": {
            "type": "string",
            "maxLength": 280
          },
          "template_id": {
            "type": "integer"
          },
          "advertiser_id": {
            "type": "integer",
            "nullable": true
          },
          "alternative_id": {
            "type": "string",
            "nullable": true,
            "description": "An ID that may be used for any reporting or administrative purpose. Limited to 191 characters.",
            "maxLength": 200
          },
          "type": {
            "type": "integer",
            "maximum": 127,
            "minimum": -128,
            "description": "Unique ID of the line item type"
          },
          "status_id": {
            "type": "integer",
            "maximum": 127,
            "minimum": -128
          },
          "width": {
            "type": "integer",
            "maximum": 2147483647,
            "minimum": -2147483648,
            "nullable": true
          },
          "height": {
            "type": "integer",
            "maximum": 2147483647,
            "minimum": -2147483648,
            "nullable": true
          },
          "sizeless": {
            "type": "integer",
            "maximum": 127,
            "minimum": -128
          },
          "click_url": {
            "type": "string",
            "nullable": true,
            "description": "Target URL when a user clicks on the ad",
            "format": "uri"
          },
          "content_tag": {
            "type": "string",
            "nullable": true
          },
          "attributes": {
            "$ref": "#/components/schemas/CreativeAttributes"
          },
          "approvals": {
            "default": []
          },
          "assets": {
            "nullable": true,
            "default": []
          },
          "addons": {
            "nullable": true,
            "default": []
          },
          "content": {
            "default": {},
            "description": "JSON document dynamically populated based on template needs (see Creative Context docs)"
          },
          "pixels": {
            "nullable": true,
            "default": []
          },
          "scripts": {
            "default": []
          },
          "click_trackers": {
            "nullable": true,
            "default": []
          },
          "events": {
            "nullable": true,
            "default": []
          },
          "progress_events": {
            "nullable": true,
            "default": []
          },
          "content_munge": {
            "type": "string",
            "nullable": true
          },
          "frequency_cap": {
            "nullable": true,
            "default": []
          },
          "primary_asset": {
            "type": "integer",
            "nullable": true
          },
          "secondary_asset": {
            "type": "integer",
            "nullable": true
          },
          "native_offer": {
            "type": "integer",
            "nullable": true
          },
          "thumbnail_url": {
            "type": "string",
            "nullable": true,
            "maxLength": 255
          },
          "preview_token": {
            "type": "string",
            "description": "read-only, for internal use. Unique token for generated UI preview"
          },
          "start_date": {
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "description": "Date/time when this creative is available for serving"
          },
          "end_date": {
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "description": "Date/time when this creative become unavailable"
          },
          "pushed_to_server": {
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "description": "read-only, for internal use. Indicates creative has been delivered to ad servers"
          },
          "content_update_date": {
            "type": "string",
            "nullable": true,
            "pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$",
            "example": "2025-09-29 00:00:00"
          },
          "secure": {
            "type": "integer",
            "maximum": 127,
            "minimum": -128,
            "nullable": true
          },
          "rule_id": {
            "type": "integer",
            "nullable": true
          },
          "rule_key": {
            "type": "string",
            "nullable": true,
            "maxLength": 20
          },
          "vendor_fees": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/VendorFee"
            },
            "description": "The list of the vendor fees objects."
          },
          "notes": {
            "type": "string",
            "nullable": true,
            "description": "Free-form notes of up to 255 characters.",
            "maxLength": 255
          },
          "video_encoding_profile_type": {
            "type": "string",
            "readOnly": true,
            "description": "Video encoding profile type derived from the primary asset."
          }
        },
        "required": [
          "account_id",
          "create_date",
          "id",
          "name",
          "template_id",
          "update_date",
          "video_encoding_profile_type"
        ]
      },
      "CreativeAttributeAdvertiser": {
        "type": "object",
        "properties": {
          "advertiser_app_bundle": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 255
            },
            "nullable": true,
            "description": "The app bundle ID of the advertiser. Some ad exchanges require any ad advertising another app to declare the app bundle of the advertised app. Max of one value is allowed in the list. When tracking using Apple's SKAdNetwork is enabled we only also setting this value at the Advertiser level, not at the Creative level."
          },
          "advertiser_category": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Canonical list of categories based on the IAB's content categories."
          },
          "advertiser_domain": {
            "type": "array",
            "items": {
              "type": "string",
              "description": "Top-level domain of the Advertiser without any path information. Required on most exchanges.",
              "format": "uri",
              "maxLength": 255
            }
          },
          "advertiser_index_id": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "nullable": true,
            "description": "Canonical list of unique Advertisers based on Google's master list. Every Creative should belong to one and only one Advertiser."
          },
          "landing_page_url": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uri",
              "maxLength": 2000
            },
            "nullable": true,
            "description": "Complete URL where creatives will ultimately land. Required for running on Google AdX. If not provided the URL defined in the advertiser will be used"
          }
        },
        "required": [
          "advertiser_category",
          "advertiser_domain"
        ]
      },
      "CreativeAttributeApproval": {
        "type": "object",
        "properties": {
          "adx_gdpr_provider": {
            "type": "array",
            "items": {
              "type": "integer"
            },
            "nullable": true
          },
          "creative_technology_vendor": {
            "type": "array",
            "items": {
              "type": "integer"
            },
            "nullable": true,
            "description": "List of technologies used by the Creative, based on Google's list. Beeswax is #632."
          },
          "iab_gdpr_provider": {
            "type": "array",
            "items": {
              "type": "integer"
            },
            "nullable": true
          },
          "creative_vendor_iab_gdpr_providers": {
            "type": "array",
            "items": {
              "type": "integer"
            },
            "nullable": true
          },
          "vendor_id": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "nullable": true,
            "description": "List of optional Creative Approval Queue vendors for Creative to be submitted. Note, these vendors are distinct from the creative_technology_vendor list, which are just declarations of which technologies are used in the creative."
          },
          "xandr_region": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 20
            },
            "nullable": true
          }
        }
      },
      "CreativeAttributeAudio": {
        "type": "object",
        "properties": {
          "audio_duration": {
            "type": "array",
            "items": {
              "type": "integer"
            },
            "description": "Duration of the audio, in seconds"
          },
          "audio_bit_rate": {
            "type": "array",
            "items": {
              "type": "integer"
            },
            "description": "Bit rate of the audio"
          },
          "audio_protocol": {
            "type": "array",
            "items": {
              "type": "integer"
            },
            "nullable": true
          },
          "audio_mime": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "MIME type of the audio, one of audio/mpeg, audio/ogg, audio/wav, audio/x-ms-wma"
          },
          "audio_companion_size": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 20
            },
            "description": "Size of the companion, if provided, in bytes"
          },
          "audio_companion_type": {
            "type": "array",
            "items": {
              "type": "integer"
            },
            "nullable": true,
            "description": "MIME type of audio companion, one of image/jpg, image/jpeg, image/png, image/gif"
          }
        }
      },
      "CreativeAttributeTechnical": {
        "type": "object",
        "properties": {
          "banner_mime": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "nullable": true,
            "description": "MIME type for this banner, eg. image/png"
          },
          "expandable_direction": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "nullable": true,
            "description": "The direction the ad will expand, as defined in OpenRTB 5.5. Multiple directions may be indicated. 1=left, 2=right, 3=up, 4=down, 5=full screen"
          },
          "expandable_type": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "nullable": true,
            "description": "The type of expandable as defined by OpenRTB 5.3. Only one type may be set. 3=automatic, 4=user initiated (click), 5=user initiated - rollover"
          },
          "tag_type": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "nullable": true,
            "description": "1=XTHML text ad, 2=XHTML banner ad, 3=Javascript ad, 4=iFrame"
          },
          "ksize": {
            "type": "array",
            "items": {
              "type": "integer"
            },
            "nullable": true,
            "description": "Size of the creative in bytes"
          }
        }
      },
      "CreativeAttributeVideo": {
        "type": "object",
        "properties": {
          "ad_id": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 255
            },
            "description": "user-provided identifier for the ad"
          },
          "clock_number": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 255
            }
          },
          "moat_in_app": {
            "type": "array",
            "items": {
              "type": "boolean"
            },
            "nullable": true,
            "description": "*deprecated*"
          },
          "moat_vpaid": {
            "type": "array",
            "items": {
              "type": "boolean"
            },
            "nullable": true,
            "description": "*deprecated*"
          },
          "skippable": {
            "type": "array",
            "items": {
              "type": "boolean"
            },
            "description": "Boolean value to indicate whether the video may be skipped by the user"
          },
          "universal_id_type": {
            "type": "array",
            "items": {
              "type": "integer"
            }
          },
          "video_autoplay": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "nullable": true,
            "description": "Value to indicate whether the ad contains autoplay video. 0=autoplay, 1=click-to-play"
          },
          "video_api": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "video_duration": {
            "type": "array",
            "items": {
              "type": "integer"
            },
            "description": "Duration of the video in seconds as an Integer. Default is 30."
          },
          "video_bit_rate": {
            "type": "array",
            "items": {
              "type": "integer"
            },
            "description": "Bit rate(s) of videos within the Creative."
          },
          "video_protocol": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "A canonical list of video protocols from the IAB's OpenRTB 6.7. Example 2=VAST 2.0."
          },
          "video_companion_type": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "A canonical list of video protocols from the IAB's OpenRTB 6.17. Example 2=HTML."
          },
          "video_companion_size": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 20
            },
            "description": "Size, in pixels, of the video's companion ad in the format <width>x<height>. Size combination is validated against the creative_sizes table."
          },
          "video_mime": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Mime types of the video within the Creative. Note, this is kept separate from banner_mime to conform with the IAB's OpenRTB schema and a single video creative can include multiple mime declarations."
          }
        }
      },
      "CreativeAttributes": {
        "type": "object",
        "properties": {
          "advertiser": {
            "allOf": [
              {
                "$ref": "#/components/schemas/CreativeAttributeAdvertiser"
              }
            ],
            "nullable": true
          },
          "approval": {
            "allOf": [
              {
                "$ref": "#/components/schemas/CreativeAttributeApproval"
              }
            ],
            "nullable": true
          },
          "mobile": {
            "allOf": [
              {
                "$ref": "#/components/schemas/CreativeAttributesMobile"
              }
            ],
            "nullable": true
          },
          "technical": {
            "allOf": [
              {
                "$ref": "#/components/schemas/CreativeAttributeTechnical"
              }
            ],
            "nullable": true
          },
          "video": {
            "allOf": [
              {
                "$ref": "#/components/schemas/CreativeAttributeVideo"
              }
            ],
            "nullable": true,
            "description": "Only for video templates"
          },
          "audio": {
            "allOf": [
              {
                "$ref": "#/components/schemas/CreativeAttributeAudio"
              }
            ],
            "nullable": true,
            "description": "Only for audio templates"
          }
        }
      },
      "CreativeAttributesMobile": {
        "type": "object",
        "properties": {
          "mraid_playable": {
            "type": "array",
            "items": {
              "type": "boolean"
            },
            "nullable": true,
            "description": "Whether the creative is a playable game in MRAID. This is required to be set when running on MoPub. Note, this is different from declaring general MRAID support, which should be accomplished using the video.video_api field (per OpenRTB)"
          }
        }
      },
      "VendorFee": {
        "type": "object",
        "properties": {
          "object_id": {
            "type": "integer"
          },
          "object_type": {
            "type": "string",
            "description": "The object_type of the VendorFee. Like line_item, campaign or creative"
          },
          "id": {
            "type": "integer"
          },
          "vendor": {
            "type": "string",
            "readOnly": true,
            "description": "The name of the vendor associated with the vendor fee. Read-only; it is derived from `vendor_id` and ignored if supplied on write."
          },
          "vendor_id": {
            "type": "integer",
            "description": "The unique identifier of the vendor associated with the vendor fee. This is the only way to set the vendor and is required."
          },
          "name": {
            "type": "string",
            "description": "The descriptive name of the vendor fee.",
            "maxLength": 100
          },
          "cpm_currency": {
            "type": "string",
            "description": "The currency code for the CPM fee amount, e.g. USD.",
            "nullable": true
          },
          "cpm_amount": {
            "type": "string",
            "format": "decimal",
            "pattern": "^-?\\d{0,3}(?:\\.\\d{0,3})?$",
            "nullable": true,
            "description": "The fee amount of the CPM, e.g. 90.123. Note that only one of `cpm_amount` and `percentage` can be specified."
          },
          "percentage": {
            "type": "string",
            "format": "decimal",
            "pattern": "^-?\\d{0,3}(?:\\.\\d{0,3})?$",
            "nullable": true,
            "description": "The fee amount in a percentage."
          },
          "read_only": {
            "type": "boolean",
            "readOnly": true,
            "default": false,
            "description": "If the vendor fee is read-only."
          },
          "create_date": {
            "type": "string",
            "nullable": true,
            "description": "The date and time the object was first created",
            "pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$",
            "example": "2025-09-29 00:00:00"
          },
          "update_date": {
            "type": "string",
            "readOnly": true,
            "nullable": true,
            "description": "The date and time the object was last updated",
            "pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$",
            "example": "2025-09-29 00:00:00"
          },
          "alternative_id": {
            "type": "string",
            "nullable": true,
            "description": "An ID that may be used for any reporting or administrative purpose. Limited to 191 characters.",
            "maxLength": 200
          },
          "notes": {
            "type": "string",
            "nullable": true,
            "description": "Free-form notes of up to 255 characters.",
            "maxLength": 255
          },
          "fee_type": {
            "type": "string",
            "description": "The key of the fee type",
            "nullable": true
          }
        },
        "required": [
          "name",
          "vendor"
        ]
      }
    },
    "securitySchemes": {
      "nestBasicAuth": {
        "type": "http",
        "scheme": "basic",
        "description": "Form-based Basic Authentication"
      },
      "nestSessionAuth": {
        "type": "http",
        "scheme": "basic",
        "description": "Form-based Basic Authentication"
      }
    }
  },
  "x-explorer-enabled": false,
  "x-samples-languages": [
    "curl",
    "node",
    "ruby",
    "javascript",
    "python",
    "php",
    "java"
  ],
  "servers": [
    {
      "url": "https://{buzz_key}.api.beeswax.com/rest/v2",
      "variables": {
        "buzz_key": {
          "default": "stingersbx",
          "description": "Unique customer ID assigned by the Beeswax"
        }
      }
    }
  ],
  "x-readme": {
    "apply-endpoint-order": true,
    "apply-tag-changes": true
  }
}
```