v1

latestOpenAPI 3.0.32026-07-13401683.8 KB

Spot Insertions

Creates a new spot insertion.

post/api/v2/spotinsertions

Request body

idinteger

The unique ID of the spot insertion. Generated at creation.

programIdinteger required

The ID of the program for the spot insertion.

broadcastServiceIdinteger required

The ID of the broadcast service for the spot insertion.

customerIdinteger

The ID of the customer who owns the spot insertion. Set to the logged-in customer at creation.

cuestring required

The cue that triggers the spot insertion.

durationinteger required

The duration of the spot insertion.

spotsinteger[] required

The ordered list of spot IDs to play.

startDatestring date required

The date the spot insertion can start in yyyyMMdd format. The time will be set to midnight Eastern Time.

endDatestring date required

The date the spot insertion ends in yyyyMMdd format. The time will be set to midnight Eastern Time.

createdDatestring date-time

The date and time the spot insertion was created in ISO 8601 format. Generated at creation.

Example request

{
  "cue": "S:000_SPOT",
  "startDate": "2020-01-31",
  "endDate": "2020-01-31"
}

Response

The created spot insertion with fields populated.