In a booking where a number of seats are bookable, like in a seats in a class. Group_owner is the main booking, specifying when the class takes place. The group_customer graph is for handling each seat-booking.

For a complete tutorial on group bookings, please refer to this article in our help center:

One special setting is important when creating a group_owner booking and that is the max_seats setting. This setting specifies the available number of seats.

This example creates a lecture class with 20 seats available.

curl --request POST \
     --url \
     --header 'Content-Type: application/json' \
     --user :live_api_key_7nzvc7wsBQQISLeFSVhROys9V1bUJ1z7
     --data '{
          "resource_id": "d187d6e0-d6cb-409a-ae60-45a8fd0ec879"
          "graph": "group_owner",
          "action": "create",
          "settings": {
            "max_seats": 20,
            "min_cancel_time": "1 day",
            "min_booking_time": "2 hours",
            "max_booking_time": "14 days"
          "start": "2016-09-30T08:00:00+00:00",
          "end": "2016-09-30T09:00:00+00:00",
          "what": "Doc Brown's lecture on flox capacitance",
          "where": "Sesame St, Middleburg, FL 32068, USA",
          "calendar_id": "bfa0b9fa-36aa-4ae6-8096-f3b20fbed1d2",
          "description": "Please arrive 10 minutes before classes begin"

The extra settings like "min_cancel_time" are optional, but this is their meaning:

min_cancel_time: Specifies the time cancellation can be done in relation to event begin time. In the example, any cancelation may be done at least 1 day/24 hours before the event starts.
min_booking_time: Specifies the minimum time that the booking must be created, before the event starts. In the example, any bookings must be created 2 hours before the event starts.
max_booking_time: Specifies the maximum time that the booking must be before the event starts. In the example, the bookings can first be created 14 days before event start.

Available actions

  • create :arrow-right: state: tentative

When in tentative state

  • cancel :arrow-right: state: cancelled
  • complete :arrow-right: state: completed

Possible states

  • tentative
  • cancelled
  • completed
  • error