---
title: "Create new booking."
slug: "create-new-booking-1"
updated: 2025-04-16T12:21:17Z
published: 2025-09-17T12:02:00Z
canonical: "docs.grassfish.com/create-new-booking-1"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.grassfish.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create new booking.

Post/api/v1/Dooh/Bookings

The parameters `playerIds` and `externalLocationIds` are mutually exclusive.

SecurityAPI Key: bearerAuthQuery parameter name
API Key: session_idHeader parameter nameX-Session-Id

Session Id

API Key: api_keyHeader parameter nameX-ApiKey

Api Key

API Key: session_cookieQuery parameter name

Body parameters<select class='api-response-data' aria-label='Media type'><option value='e7d8e64e-6721-48d0-bdd6-82ddd3dc14d6'>application/json</option>
<option value='58c05bbf-b2d0-465f-a980-92e602ab4b14'>text/json</option>
<option value='a7120880-0d90-44b6-aa2a-9a0242b76676'>application/*+json</option>
</select>Expand Allobject  

Represents a request to create a new booking, including spot, product, client, campaign details, booking time range, assigned players, hub numbers, and targeting options.

spotIdinteger  (int32)    

Gets or sets the spot ID for the booking.

productIdinteger  (int32)    

Gets or sets the product ID for the booking.

clientIdinteger  (int32)    Required

Gets or sets the client ID for the booking.

campaignstring   | null  

Gets or sets the campaign name.

brandstring   | null  

Gets or sets the brand name.

descriptionstring   | null  

Gets or sets the booking description.

isReservedboolean    Required

Gets or sets a value indicating whether the booking is reserved.

ignoreCapacityValidationboolean    

Gets or sets a value indicating whether to ignore product capacity validation. If `true`, booking will be ordered even if it exceeds the product capacity.

fromstring  (date-time)    Required

Gets or sets the booking start time.

Example2024-04-15T08:00:00Z
tostring  (date-time)    Required

Gets or sets the booking end time.

Example2024-04-30T20:00:00Z
validDayTimes Array of object (TimeRange)  | null  

Gets or sets the valid time periods. If omitted, booking will play all day long.

object  

Represents a time range with a start and end time in "HH:mm" format.

fromstring   | null  

Gets or sets the start time in "HH:mm" format.

Pattern\d{2}:\d{2}Example08:00
tostring   | null  

Gets or sets the end time in "HH:mm" format.

Pattern\d{2}:\d{2}Example22:00

liveTags Array of object (LiveTag)  | null  

Gets or sets the live tags. Only applicable for LiveTag products.

object  

Represents a live tag with a parent tag and associated child tag ids.

parentTagIdinteger  (int32)    

Gets or sets the identifier of the parent tag.

childTagIds Array of integer  | null  

Gets or sets the list of child tag ids.

integer  (int32)    

playerIds Array of integer  | null  

Gets or sets the assigned player IDs.

integer  (int32)    
externalLocationIds Array of string  | null  

Gets or sets the assigned external location IDs.

string    
targetPlaybacksinteger  (int32)   | null  

Gets or sets the target playback count. Only applicable for LiveTag and Playback products.

Example10000
targetShareOfVoicePercentageinteger  (int32)   | null  

Gets or sets the target percentage. Only applicable for ShareOfVoice products.

Minimum0.0Maximum100.0Example10
targetFrequencyinteger  (int32)   | null  

Gets or sets the target frequency. Only applicable for Frequency products.

Example120

Expand Allobject  

Represents a request to create a new booking, including spot, product, client, campaign details, booking time range, assigned players, hub numbers, and targeting options.

spotIdinteger  (int32)    

Gets or sets the spot ID for the booking.

productIdinteger  (int32)    

Gets or sets the product ID for the booking.

clientIdinteger  (int32)    Required

Gets or sets the client ID for the booking.

campaignstring   | null  

Gets or sets the campaign name.

brandstring   | null  

Gets or sets the brand name.

descriptionstring   | null  

Gets or sets the booking description.

isReservedboolean    Required

Gets or sets a value indicating whether the booking is reserved.

ignoreCapacityValidationboolean    

Gets or sets a value indicating whether to ignore product capacity validation. If `true`, booking will be ordered even if it exceeds the product capacity.

fromstring  (date-time)    Required

Gets or sets the booking start time.

Example2024-04-15T08:00:00Z
tostring  (date-time)    Required

Gets or sets the booking end time.

Example2024-04-30T20:00:00Z
validDayTimes Array of object (TimeRange)  | null  

Gets or sets the valid time periods. If omitted, booking will play all day long.

object  

Represents a time range with a start and end time in "HH:mm" format.

fromstring   | null  

Gets or sets the start time in "HH:mm" format.

Pattern\d{2}:\d{2}Example08:00
tostring   | null  

Gets or sets the end time in "HH:mm" format.

Pattern\d{2}:\d{2}Example22:00

liveTags Array of object (LiveTag)  | null  

Gets or sets the live tags. Only applicable for LiveTag products.

object  

Represents a live tag with a parent tag and associated child tag ids.

parentTagIdinteger  (int32)    

Gets or sets the identifier of the parent tag.

childTagIds Array of integer  | null  

Gets or sets the list of child tag ids.

integer  (int32)    

playerIds Array of integer  | null  

Gets or sets the assigned player IDs.

integer  (int32)    
externalLocationIds Array of string  | null  

Gets or sets the assigned external location IDs.

string    
targetPlaybacksinteger  (int32)   | null  

Gets or sets the target playback count. Only applicable for LiveTag and Playback products.

Example10000
targetShareOfVoicePercentageinteger  (int32)   | null  

Gets or sets the target percentage. Only applicable for ShareOfVoice products.

Minimum0.0Maximum100.0Example10
targetFrequencyinteger  (int32)   | null  

Gets or sets the target frequency. Only applicable for Frequency products.

Example120

Expand Allobject  

Represents a request to create a new booking, including spot, product, client, campaign details, booking time range, assigned players, hub numbers, and targeting options.

spotIdinteger  (int32)    

Gets or sets the spot ID for the booking.

productIdinteger  (int32)    

Gets or sets the product ID for the booking.

clientIdinteger  (int32)    Required

Gets or sets the client ID for the booking.

campaignstring   | null  

Gets or sets the campaign name.

brandstring   | null  

Gets or sets the brand name.

descriptionstring   | null  

Gets or sets the booking description.

isReservedboolean    Required

Gets or sets a value indicating whether the booking is reserved.

ignoreCapacityValidationboolean    

Gets or sets a value indicating whether to ignore product capacity validation. If `true`, booking will be ordered even if it exceeds the product capacity.

fromstring  (date-time)    Required

Gets or sets the booking start time.

Example2024-04-15T08:00:00Z
tostring  (date-time)    Required

Gets or sets the booking end time.

Example2024-04-30T20:00:00Z
validDayTimes Array of object (TimeRange)  | null  

Gets or sets the valid time periods. If omitted, booking will play all day long.

object  

Represents a time range with a start and end time in "HH:mm" format.

fromstring   | null  

Gets or sets the start time in "HH:mm" format.

Pattern\d{2}:\d{2}Example08:00
tostring   | null  

Gets or sets the end time in "HH:mm" format.

Pattern\d{2}:\d{2}Example22:00

liveTags Array of object (LiveTag)  | null  

Gets or sets the live tags. Only applicable for LiveTag products.

object  

Represents a live tag with a parent tag and associated child tag ids.

parentTagIdinteger  (int32)    

Gets or sets the identifier of the parent tag.

childTagIds Array of integer  | null  

Gets or sets the list of child tag ids.

integer  (int32)    

playerIds Array of integer  | null  

Gets or sets the assigned player IDs.

integer  (int32)    
externalLocationIds Array of string  | null  

Gets or sets the assigned external location IDs.

string    
targetPlaybacksinteger  (int32)   | null  

Gets or sets the target playback count. Only applicable for LiveTag and Playback products.

Example10000
targetShareOfVoicePercentageinteger  (int32)   | null  

Gets or sets the target percentage. Only applicable for ShareOfVoice products.

Minimum0.0Maximum100.0Example10
targetFrequencyinteger  (int32)   | null  

Gets or sets the target frequency. Only applicable for Frequency products.

Example120

Responses200

OK

<select class='api-response-data' aria-label='Media type'><option value='6822551a-4763-474d-b9c3-f264d63b5bba'>text/plain</option>
<option value='85ebc3be-8ec2-495c-b40b-16240e045f94'>application/json</option>
<option value='a3fd144f-d974-4eea-a4b1-71a6ee335c82'>text/json</option>
</select>integer  (int32)    
integer  (int32)    
integer  (int32)    

400

Bad Request

<select class='api-response-data' aria-label='Media type'><option value='117842c7-977b-4e08-917f-374fb458dfae'>text/plain</option>
<option value='e0e6453d-0020-47e9-a53b-8d0ba539be9c'>application/json</option>
<option value='a045ae34-2ffa-481c-a809-0debab24554b'>text/json</option>
</select>object  typestring   | null  
titlestring   | null  
statusinteger  (int32)   | null  
detailstring   | null  
instancestring   | null  
property*

object  typestring   | null  
titlestring   | null  
statusinteger  (int32)   | null  
detailstring   | null  
instancestring   | null  
property*

object  typestring   | null  
titlestring   | null  
statusinteger  (int32)   | null  
detailstring   | null  
instancestring   | null  
property*

401

Unauthorized

<select class='api-response-data' aria-label='Media type'><option value='c5bc1122-5757-44fb-9c60-ab160310f796'>text/plain</option>
<option value='3774f1a1-6cfe-41d8-817e-f4929f896ef0'>application/json</option>
<option value='71872b25-442b-456d-9128-c8f4fbfb8f48'>text/json</option>
</select>object  typestring   | null  
titlestring   | null  
statusinteger  (int32)   | null  
detailstring   | null  
instancestring   | null  
property*

object  typestring   | null  
titlestring   | null  
statusinteger  (int32)   | null  
detailstring   | null  
instancestring   | null  
property*

object  typestring   | null  
titlestring   | null  
statusinteger  (int32)   | null  
detailstring   | null  
instancestring   | null  
property*

403

Forbidden

<select class='api-response-data' aria-label='Media type'><option value='d55c4992-ba0c-4514-bfc4-a7a55daf6fc0'>text/plain</option>
<option value='a1f84ce2-75b5-4fb2-88e9-16331602c100'>application/json</option>
<option value='bcce3718-05eb-4b00-8360-e5df302794d6'>text/json</option>
</select>object  typestring   | null  
titlestring   | null  
statusinteger  (int32)   | null  
detailstring   | null  
instancestring   | null  
property*

object  typestring   | null  
titlestring   | null  
statusinteger  (int32)   | null  
detailstring   | null  
instancestring   | null  
property*

object  typestring   | null  
titlestring   | null  
statusinteger  (int32)   | null  
detailstring   | null  
instancestring   | null  
property*

409

Conflict

<select class='api-response-data' aria-label='Media type'><option value='aec80848-8ffa-4aa5-8b50-272ab13b4c33'>text/plain</option>
<option value='41cb4ebb-f70d-4365-8b8e-2121220dfd78'>application/json</option>
<option value='069c596e-5e98-4784-96ee-f1af03d3e1ec'>text/json</option>
</select>object  typestring   | null  
titlestring   | null  
statusinteger  (int32)   | null  
detailstring   | null  
instancestring   | null  
property*

object  typestring   | null  
titlestring   | null  
statusinteger  (int32)   | null  
detailstring   | null  
instancestring   | null  
property*

object  typestring   | null  
titlestring   | null  
statusinteger  (int32)   | null  
detailstring   | null  
instancestring   | null  
property*

default

Error

<select class='api-response-data' aria-label='Media type'><option value='20ef3532-33fa-4ec6-93f6-54f53bba4455'>text/plain</option>
<option value='9a18bab3-bdc1-4da2-b3e3-5b43e2908e5d'>application/json</option>
<option value='694506d6-593e-4a21-a300-4c811f6c66ac'>text/json</option>
</select>object  typestring   | null  
titlestring   | null  
statusinteger  (int32)   | null  
detailstring   | null  
instancestring   | null  
property*

object  typestring   | null  
titlestring   | null  
statusinteger  (int32)   | null  
detailstring   | null  
instancestring   | null  
property*

object  typestring   | null  
titlestring   | null  
statusinteger  (int32)   | null  
detailstring   | null  
instancestring   | null  
property*