---
title: "Create a new MeterAd"
method: POST
path: "/v1/admin/meter-ads"
tags: ["meter-ads"]
---

# Create a new MeterAd

`POST /v1/admin/meter-ads`

## Request body

- CreateMeterAdDto
  - `partnerId` string, required
  - `startTime` number, required — Unix timestamp in milliseconds
  - `endTime` number, required — Unix timestamp in milliseconds
  - `questionText` string, required
  - `marketingText` string — Frontend will supply a default if not provided
  - `sideA` AdSideDto, required
    - `label` string, required
    - `percentage` number, required
    - `assetUrl` string, uri, required
  - `sideB` AdSideDto, required
    - `label` string, required
    - `percentage` number, required
    - `assetUrl` string, uri, required
  - `status` 'DRAFT' | 'PUBLISHED' | 'CANCELLED', required
  - `url` string

## Response `201`

A MeterAd entity

- MeterAd
  - `id` string, required
  - `partnerId` string, required
  - `startTime` number, required — Unix timestamp in milliseconds
  - `endTime` number, required — Unix timestamp in milliseconds
  - `questionText` string, required
  - `marketingText` string
  - `sideA` object
    - `label` string, required — Label for side A
    - `percentage` number, required — Percentage allocated to side A (0-100)
    - `assetUrl` string, required — URL to the asset for side A
  - `sideB` object
    - `label` string, required — Label for side B
    - `percentage` number, required — Percentage allocated to side B (0-100)
    - `assetUrl` string, required — URL to the asset for side B
  - `status` 'DRAFT' | 'PUBLISHED' | 'CANCELLED', required
  - `createdAt` string, date-time, required — Unix Timestamp in milliseconds of when the record was created
  - `updatedAt` string, date-time, required — Unix Timestamp in milliseconds of when the record was last updated
  - `url` string, required

---

[API](https://skmtc.net/versusgame/apis/versusgame-api.md) · [All operations](https://skmtc.net/versusgame/apis/versusgame-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/versusgame/versusgame-api/revisions/e86f45ae5f7c/schema)