Skip to main content
POST
/
bookings
/
create-booking
Create a new booking
curl --request POST \
  --url http://localhost:3000/api/bookings/create-booking \
  --header 'Content-Type: application/json' \
  --data '
{
  "userId": "<string>",
  "artistUserId": "<string>",
  "requestType": "<string>",
  "description": "<string>",
  "isCoverUp": true,
  "color": "<string>",
  "tattooPlacement": [
    "<string>"
  ],
  "tattooStyle": [
    "<string>"
  ],
  "selectedDates": [
    "2023-12-25"
  ],
  "desiredTimeOfDay": "Morning",
  "isOver18": true,
  "isPolicyAccepted": true,
  "length": "<string>",
  "width": "<string>",
  "otherTattooPlacement": "<string>",
  "images": [
    "<string>"
  ],
  "links": [
    "<string>"
  ],
  "additionalDateComments": "<string>",
  "medicalConditions": "<string>"
}
'
{
  "success": true
}

Body

application/json
​
userId
string
required

ID of the user making the booking

​
artistUserId
string
required

ID of the artist being booked

​
requestType
string
required

Type of booking request

​
description
string
required

Description of the tattoo request

Required string length: 30 - 1000
​
isCoverUp
boolean
required

Whether this is a cover-up tattoo

​
color
string
required

Color preference for the tattoo

​
tattooPlacement
string[]
required

Selected placement areas for the tattoo

Minimum array length: 1
​
tattooStyle
string[]
required

Selected tattoo styles

Minimum array length: 1
​
selectedDates
string<date>[]
required

Preferred dates for the tattoo session

​
desiredTimeOfDay
enum<string>
required

Preferred time of day for the session

Available options:
Morning,
Afternoon,
Either
​
isOver18
boolean
required

Confirmation that the client is over 18

​
isPolicyAccepted
boolean
required

Confirmation that the client accepts the policy

​
length
string

Length of the tattoo (optional, must be a positive number if provided)

​
width
string

Width of the tattoo (optional, must be a positive number if provided)

​
otherTattooPlacement
string

Custom placement if not in standard options

​
images
string[]

Array of image URLs or base64 strings (optional, but either images or links must be provided)

​
links
string<uri>[]

Reference links for the tattoo design (optional, but either images or links must be provided)

​
additionalDateComments
string

Additional comments about date preferences

​
medicalConditions
string

Any relevant medical conditions

Response

Booking created successfully

​
success
boolean
required

Whether the operation was successful