Create a creative add-on

post

https://{buzz_key}.api.beeswax.com/rest/v2/creative-addons

Create a new creative add-on with the provided details.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Read-side shape shared by the detail and global-view serializers.

account_id

integer

required

Defaults to the account in the active session

advertiser_id

integer | null

The advertiser the add-on belongs to. Null for account-level add-ons.

name

string

required

length ≤ 191

^[\w[('-]

content

string

required

URL or payload that defines the pixel/script or other tag executed by this creative add-on

type

string

enum

required

The kind of add-on markup carried in content.

SCRIPT - Script
PIXEL - Pixel
WRAPPER - Wrapper

Allowed:

creative_type

string | null

The creative type the add-on applies to: banner, video, native or any. Defaults to banner.

include_by_default

boolean

Defaults to false

Whether this add-on is automatically applied to all new creatives of the same creative type

secure

boolean

Defaults to false

Whether the add-on's URL is SSL-compliant (HTTPS) and safe for secure inventory environments

vendor_id

integer | null

Numeric ID of the vendor associated with this creative add-on; references the Vendor object for billing and configuration.

vendor_buzz_key

string | null

Canonical vendor key string (for example 'IAS', 'HUMAN', 'MOAT') that identifies the vendor in the Vendor configuration

global_field

boolean

Defaults to false

cpm_cost

string | null

^-?\d{0,2}(?:\.\d{0,3})?$

Cost per thousand impressions charged by the vendor, from 0 to 99.99 with up to 3 decimal places.

currency

string | null

Currency key, for example USD. Defaults to the account's CURRENCIES_DEFAULT setting.

active

boolean

Defaults to true

alternative_id

string | null

An ID that may be used for any reporting or administrative purpose. Limited to 191 characters.

notes

string | null

Free-form notes of up to 255 characters.

Headers

content-type

string

enum

Defaults to application/json

Generated from available request content types

Allowed:

Responses

400

Invalid data provided.

401

Authentication credentials were not provided.

403

Permission denied.

500

Internal Server Error

201Creative add-on created successfully.