Skip to main content
POST
Error

Authorizations

X-Internal-Token
string
header
required

The data-platform SERVICE token (DATA_PLATFORM_API_TOKEN) in the X-Internal-Token header. Guards the machine-only incremental CDC export; not a user credential and never a POS session — reachable only server-to-server.

Body

application/json
promotions
any[]
required

The pushed promotions; each item is re-validated server-side and reported per row.

Minimum array length: 1

Response

A per-row report: every pushed item as created / skipped / failed.

A per-row report: every pushed item as created / skipped / failed.

results
object[]
required

One entry per pushed item, in payload order.

created
integer
required

How many items were newly persisted.

Required range: 0 <= x <= 9007199254740991
skipped
integer
required

How many already existed (no-op / idempotent).

Required range: 0 <= x <= 9007199254740991
failed
integer
required

How many were rejected (see each reason).

Required range: 0 <= x <= 9007199254740991