- Create powerful apps with Jicoo's API
- Quick start
- Authentication
- Errors
- Versioning
- Types
- API Reference Overview
- Guide
- Guide(Japanese)
- API Reference
- Jicoo API
- Webhook Schema
- Booking
- Schedule
- Availability
- Oraganization
- Event Types
Create Booking
POST
/v1/bookings
Request
Authorization
Add parameter in header
X-Jicoo-Api-Key
Example:
X-Jicoo-Api-Key: ********************
Body Params application/json
startedAt
string <date-time>
required
timeZone
string
required
eventTypeId
string
required
email
string <email>
required
<= 255 characters
name
string
required
<= 64 characters
company
string
optional
<= 32 characters
textRemindCountryCode
string
optional
<= 255 characters
textRemindNumber
string
optional
<= 32 characters
ccEmails
array[string]
optional
<= 30 items
message
string
optional
<= 2000 characters
locale
enum<string>
optional
Allowed values:
jaen
locationId
required
Any of
Allowed values:
inPersonphonezoomgoogleMeetaskInviteeteamscustom
phoneNumber
string
optional
<= 32 characters
tracking
object
optional
campaign
string
optional
<= 255 characters
source
string
optional
<= 255 characters
medium
string
optional
<= 255 characters
content
string
optional
<= 255 characters
term
string
optional
<= 255 characters
answers
array [object {2}]
optional
questionUid
string
required
content
required
payment
object
optional
paymentMethod
enum<string>
required
Allowed values:
nonecardonsite
items
array [object {1}]
required
successUrl
string <uri>
optional
cancelUrl
string <uri>
optional
Example
{
"eventTypeId": "mzgdPJVBb7RE",
"timeZone": "Asia/Tokyo",
"startedAt": "2024-03-16T02:00:00.000Z",
"email": "guest@example.com",
"name": "john doe",
"location": null
}
Request samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/v1/bookings' \
--header 'Content-Type: application/json' \
--header 'X-Jicoo-Api-Key;' \
--data-raw '{
"eventTypeId": "mzgdPJVBb7RE",
"timeZone": "Asia/Tokyo",
"startedAt": "2024-03-16T02:00:00.000Z",
"email": "guest@example.com",
"name": "john doe",
"location": null
}'
Responses
🟢201Created
application/json
Body
data
required
Any of
uid
string
required
eventTypeId
string | null
required
name
string
required
description
string | null
required
status
enum<string>
required
Allowed values:
requestopencancel
startedAt
string <date-time>
required
endedAt
string <date-time>
required
locationId
required
url
string | null
required
phoneNumber
string | null
required
address
string | null
required
customLocation
string | null
required
access
string | null
required
timeZone
string
required
priority
required
cancelReason
string | null
required
cancelledAt
required
cancelledBy
required
hosts
array [object {2}]
required
createdAt
string <date-time>
required
updatedAt
string <date-time>
required
Examples
{
"eventTypeId": null,
"uid": "dolor id nostrud Excepteur dolore",
"name": "nostrum neque nostrum",
"description": "Facere non eveniet illo veritatis doloribus id quos omnis nemo. Facilis quis assumenda sunt. Unde iusto porro placeat. Itaque amet aut voluptas facilis rerum illo error.",
"status": "open",
"startedAt": "1989-06-01T18:37:12.594Z",
"endedAt": "1984-11-20T03:14:06.112Z",
"locationId": "phone",
"url": "https://acrobatic-son.org",
"phoneNumber": "(648) 998-7709 x67849",
"address": null,
"customLocation": "eiusmod",
"access": null,
"timeZone": "Atlantic/Azores",
"priority": "high",
"cancelReason": "veniam fugiat quis elit",
"cancelledAt": null,
"cancelledBy": null,
"capacity": null,
"hosts": [
{
"userId": "non",
"role": "editor"
}
],
"createdAt": "2024-03-04T07:26:55.198Z",
"updatedAt": "2024-03-04T05:10:21.686Z"
}
🟠409Conflict
Modified at 2024-11-20 06:43:44