Skip to main content

​
Create Your First Event

This guide will walk you through making your first API request to create an event in BookingShake.

​
Prerequisites

Before you begin, make sure you have:
Your BookingShake API key from Settings > Integrations
A tool to make HTTP requests (cURL, Postman, or your preferred HTTP client)

​
Step 1: Get Your API Key

1

Access BookingShake Dashboard

Log in to your account at crm.bookingshake.com
2

Navigate to Integrations

Go to Settings > Integrations
3

Copy Your API Key

Copy your API key and store it securely
Replace YOUR_API_KEY in all examples below with your actual API key.

​
Step 2: Retrieve Available Resources

Before creating an event, let’s retrieve available sources and spaces to use in our booking.

​
Get Booking Sources

curl -X GET 'https://api.bookingshake.io/api/sources' \
  -H 'Authorization: Bearer YOUR_API_KEY'

[
  {
    "value": "src_website",
    "label": "Website"
  },
  {
    "value": "src_phone",
    "label": "Phone"
  }
]

​
Get Available Spaces

curl -X GET 'https://api.bookingshake.io/api/spaces' \
  -H 'Authorization: Bearer YOUR_API_KEY'

[
  {
    "value": "space_conf_a",
    "label": "Conference Room A"
  },
  {
    "value": "space_ballroom",
    "label": "Grand Ballroom"
  }
]

​
Step 3: Create a Simple Event

Now let’s create your first event with basic information. 
curl -X POST 'https://api.bookingshake.io/api/events/create' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "bookings": [
      {
        "date": "15-03-2025",
        "startTime": "14:00",
        "endTime": "18:00",
        "pax": "50",
        "event_type": "Corporate Event"
      }
    ],
    "contact": {
      "first_name": "John",
      "last_name": "Doe",
      "email": "[email protected]",
      "phone": "+33123456789"
    },
    "source_slug": "website"
  }'

{
  "message": "success"
}
Congratulations! You’ve successfully created your first event via the BookingShake API.

​
Step 4: Verify in Dashboard

After creating the event, you can verify it in your BookingShake dashboard:
  1. Log in to crm.bookingshake.com
  2. Navigate to your events/bookings list
  3. Look for the newly created event with John Doe as the contact

​
What’s Next?

Now that you’ve created your first event, explore these advanced features:

Create Multiple Events

Learn how to create multiple events in a single request

Add Products

Create draft quotations by including products with your events

Company Information

Add company details to your bookings

Error Handling

Learn how to handle errors gracefully

​
Common Issues

Make sure dates are in DD-MM-YYYY format:
  • ✅ Correct: "15-03-2025"
  • ❌ Incorrect: "2025-03-15" or "03/15/2025"
Make sure times are in HH:mm format (24-hour):
  • ✅ Correct: "14:00" or "09:30"
  • ❌ Incorrect: "2:00 PM" or "14:00:00"
Ensure the Authorization header is included:
Authorization: Bearer YOUR_API_KEY
Verify your API key is correct and hasn’t been revoked. Get a fresh key from Settings > Integrations.

​
Need Help?

Contact Support

Our support team is here to help you get started