Jicoo Developer Potal
  1. Booking
Jicoo Developer Potal
  • Create powerful apps with Jicoo's API
  • Quick start
  • Authentication
  • Errors
  • Versioning
  • Types
  • API Reference Overview
  • Guide
    • How to use webhook
    • How to use Account integration
  • Guide(Japanese)
    • アカウント連携の使い方
    • Webhookの使い方
    • ホストの優先度を更新する方法
  • API Reference
    • Jicoo API
    • Webhook Schema
      • Webhook schema
      • event property
      • createdAt property
      • object property
      • contact property
      • answers property
      • answers items property
      • tracking property
    • Booking
      • List Bookings
        GET
      • Get Booking
        GET
      • Cancel Booking
        POST
      • Reschedule Booking
        POST
      • Create Booking
        POST
      • Update Booking
        PATCH
      • Get Booking Contacts
        GET
    • Schedule
      • Update Schedule
      • Create Schedule
      • List Schedules
      • Delete Schedule
    • Availability
      • List User Availability Calendars
      • Get User Availability Calendar
    • Oraganization
      • User
        • List Organization Users
        • Delete Organization User
        • Get Organization User
        • Update Organization User
      • Invitation
        • Create Organiztion Invitation
        • List Organization Invitations
        • Get Organization Invitation
        • Delete Organiztion Invitation
      • Get Organization Team
    • Event Types
      • Get Event Type
      • List Event Types
      • List Event Type Hosts
      • Get Event Type Available Schedules
      • Account Integration
      • Update Event Type Host
      • Delete Event Type Host
      • Create Event Type Host
  1. Booking

Create Booking

POST
/v1/bookings
The Create Booking API allows users to make a new booking. By submitting necessary details such as service selection, contact information, and preferred time slots, this API will create a new booking in the system. Upon successful creation, the API returns the booking details and a unique identifier for future reference.

Request

Authorization
Add parameter in header
X-Jicoo-Api-Key
Example:
X-Jicoo-Api-Key: ********************
Body Params application/json

Example
{
    "eventTypeId": "mzgdPJVBb7RE",
    "timeZone": "Asia/Tokyo",
    "startedAt": "2024-03-16T02:00:00.000Z",
    "email": "guest@example.com",
    "name": "john doe",
    "location": null
}

Request Code 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

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
Previous
Reschedule Booking
Next
Update Booking
Built with