---
title: "Create a Pixel Bundle"
method: POST
path: "/pixel_bundles"
tags: ["Pixel Bundles"]
---

# Create a Pixel Bundle

`POST /pixel_bundles`

## Request

- Base URL: `https://api.mediamath.com/api/v3.0`
- URL: `https://api.mediamath.com/api/v3.0/pixel_bundles`
- Auth: OAuth 2
  - Authorization code: `https://auth.mediamath.com/authorize`
  - Token URL: `https://auth.mediamath.com/oauth/token` scopes: `offline_access`, `manage:services`
- TypeScript: <https://skmtc.dev/mediamath/apis/campaigns-api/docs/pixel_bundles/post.ts> (a function with typed inputs; its response is checked against the schema)

Create a pixel bundle

## Request body

- object
  - `event_urls` string[], nullable
  - `container_tags` string[], nullable
  - `pixel_type` 'creative' | 'event' | 'data' | 'segment' | 'dynamic', required
  - `advertiser_id` integer, nullable
  - `agency_id` integer, nullable
  - `id` integer
  - `provider_id` integer, nullable
  - `name` string, required
  - `cost_pct_cpm` number, nullable
  - `eligible` boolean
  - `tags` string, nullable
  - `cost_cpm` number, nullable
  - `external_identifier` string
  - `tag_type` 'dfa' | 'uat' | 'image' | 'iframe' | 'js', required
  - `pricing` 'CPM' | 'CPTS', nullable
  - `cost_cpts` number, nullable
  - `segment_op` 'AND' | 'OR', nullable
  - `rmx_friendly` boolean
  - `rmx_merit` boolean
  - `rmx_pc_window_minutes` integer, nullable
  - `rmx_pv_window_minutes` integer, nullable
  - `rmx_conversion_type` 'one' | 'variable'
  - `rmx_conversion_minutes` integer
  - `currency` 'S1' | 'S2' | 'V1' | 'V2', nullable
  - `revenue` 'S1' | 'S2' | 'V1' | 'V2', nullable
  - `currency_fixed` string, nullable
  - `status` boolean

## Response `201`

Pixel bundle created response

- object
  - `data` PixelBundleResponse
    - `pixel_type` 'creative' | 'event' | 'data' | 'segment' | 'dynamic'
    - `advertiser_id` integer, nullable
    - `agency_id` integer, nullable
    - `id` integer
    - `provider_id` integer, nullable
    - `name` string
    - `cost_pct_cpm` number, nullable
    - `eligible` boolean
    - `tags` string, nullable
    - `cost_cpm` number, nullable
    - `external_identifier` string
    - `tag_type` 'dfa' | 'uat' | 'image' | 'iframe' | 'js'
    - `pricing` 'CPM' | 'CPTS', nullable
    - `cost_cpts` number, nullable
    - `segment_op` 'AND' | 'OR', nullable
    - `rmx_friendly` boolean
    - `rmx_merit` boolean
    - `rmx_pc_window_minutes` integer, nullable
    - `rmx_pv_window_minutes` integer, nullable
    - `rmx_conversion_type` 'one' | 'variable'
    - `rmx_conversion_minutes` integer
    - `currency` 'S1' | 'S2' | 'V1' | 'V2', nullable
    - `revenue` 'S1' | 'S2' | 'V1' | 'V2', nullable
    - `currency_fixed` string, nullable
    - `status` boolean
    - `event_urls` string[], nullable
    - `container_tags` string[], nullable
    - `version` integer
  - `meta` object
    - `status` string

## Other responses

- `400`: Error response
- `401`: Error response
- `403`: Error response

---

[API](https://skmtc.dev/mediamath/apis/campaigns-api.md) - [All operations](https://skmtc.dev/mediamath/apis/campaigns-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mediamath/apis/campaigns-api/revisions/408743891def?raw)