---
title: "Post a promotion, special, event or ad against a business you submitted"
method: POST
path: "/api/agent/promo"
---

# Post a promotion, special, event or ad against a business you submitted

`POST /api/agent/promo`

## Request

- Base URL: `https://itsnum.com`
- URL: `https://itsnum.com/api/agent/promo`
- Auth: HTTP bearer

## Request body

- object
  - `submission_id` string
  - `external_ref` string
  - `promo_ref` string
  - `kind` 'promo' | 'special' | 'event' | 'ad'
  - `title` string, required
  - `detail` string
  - `starts_at` string
  - `ends_at` string
  - `discount_pct` integer
  - `terms` string

## Response `201`

Accepted, pending human review.

- object

---

[API](https://skmtc.dev/itsnum/apis/num-agent-api.md) · [All operations](https://skmtc.dev/itsnum/apis/num-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/itsnum/apis/num-agent-api/revisions/cccc8bfd7446?raw)