For full functionality of this site it is necessary to enable JavaScript. Here are the instructions how to enable JavaScript in your web browser.
 You are using an out of date browser, we suggest you upgrade. You may continue if you wish, but aspects of the site may not function correctly.

Webhook/Push Notification

For many enterprise clients, integrations into existing systems are a crucial part of their appointments and events strategy. Data in BookingBug is highly useful for a range of downstream processes including building a single customer view in a CRM system, co-ordinating marketing efforts, sending booking related comms to customers – the use cases are vast and differ by client and industry.

BookingBug have an existing push notification service that sends a json block data to an http endpoint for clients to consume. The following push notification triggers exist as standard:

  • Booking created
  • Booking amended/moved to a different date/time
  • Booking cancelled

Setup & config

As a prerequisite the client will need to configure an https API endpoint for BookingBug data to be sent to.

Within BookingBug you can configure the following attributes within Advanced Settings > API Settings

Settings:

  • Booking callback Notification URL
  • Cancellation callback Notification URL
  • Basic auth username
  • Basic auth password

Once this is configured you can make test bookings and check that data is hitting the configured endpoints. One great way of testing this is using an online HTTP request service such as putsreq, requestbin to name a few.

If you are not receiving notifications at this point, check for error messages. A common failure point is SSL certificates. For other issues, please speak with your BookingBug implementation manager.

Note that if you have only configured a Booking Callback Notification url then all notifications will be sent there (including update & cancellations).

Sample JSON

Request Body

{
  "total_price": 1500,
  "price": 1500,
  "paid": 1500,
  "deposit": 0,
  "tax_payable_on_price": 0,
  "tax_payable_on_deposit": 0,
  "tax_payable_on_due_now": 0,
  "due_now": 0,
  "long_id": "IDXODKIPiQo321uMMTe2MTA0NDE%3D",
  "id": 11610441,
  "client_name": "Test Gladden",
  "created_at": "2017-03-07T09:30:31Z",
  "certificate_paid": 0,
  "payment_type": "online",
  "last_payment_log": {
    "success": true,
    "response": "{\"card_details\":null,\"address\":null,\"response\":null}"
  },
  "payment_reference": [],
  "_embedded": {
    "client": {
      "first_name": "Test",
      "last_name": "Gladden",
      "email": "test@bookingbug.com",
      "address1": "null",
      "address2": "null",
      "address3": "",
      "address4": "",
      "address5": ".",
      "postcode": "null",
      "country": "null",
      "mobile": "12345678910",
      "phone_prefix": "44",
      "mobile_prefix": "44",
      "id": 3056937,
      "answers": [],
      "deleted": false,
      "notifications": {},
      "client_type": "Member",
      "reference": "QWERTY123",
      "_links": {
        "self": {
          "href": "https://{host}.bookingbug.com/api/v1/50579/client/3056937"
        },
        "questions": {
          "href": "https://{host}.bookingbug.com/api/v1/50579/client_details"
        }
      }
    },
    "member": {
      "id": 3056937,
      "name": "Test Gladden",
      "first_name": "Test",
      "last_name": "Gladden",
      "comp_ref": "QWERTY123",
      "client_type": "Member",
      "email": "test@bookingbug.com",
      "address1": "null",
      "address2": "null",
      "address3": "",
      "address4": "",
      "address5": ".",
      "postcode": "null",
      "country": "null",
      "phone_prefix": "44",
      "mobile": "12345678910",
      "mobile_prefix": "44",
      "path": "https://{host}.bookingbug.com/api/v1",
      "company_id": 50579,
      "has_active_wallet": false,
      "has_wallet": false,
      "member_level_id": 5,
      "_links": {
        "self": {
          "href": "https://{host}.bookingbug.com/api/v1/50579/members/3056937{?embed}",
          "templated": true
        },
        "bookings": {
          "href": "https://{host}.bookingbug.com/api/v1/50579/members/3056937/bookings{?start_date,end_date,include_cancelled,page,per_page}",
          "templated": true
        },
        "pre_paid_bookings": {
          "href": "https://{host}.bookingbug.com/api/v1/50579/members/3056937/pre_paid_bookings{?include_invalid,event_id}",
          "templated": true
        },
        "purchase_totals": {
          "href": "https://{host}.bookingbug.com/api/v1/50579/members/3056937/purchase_totals{?start_date,end_date,page,per_page}",
          "templated": true
        },
        "edit_member": {
          "href": "https://{host}.bookingbug.com/api/v1/50579/members/3056937/edit"
        },
        "company": {
          "href": "https://{host}.bookingbug.com/api/v1/company/50579"
        },
        "update_password": {
          "href": "https://{host}.bookingbug.com/api/v1/login/50579/update_password/3056937"
        },
        "send_welcome_email": {
          "href": "https://{host}.bookingbug.com/api/v1/50579/members/3056937/send_welcome_email"
        }
      }
    },
    "bookings": [
      {
        "id": 13477736,
        "full_describe": "Microchipping with Waqas  - Consultation Room 1 at Waqas Ahmad Child",
        "describe": "Fri 10th Mar 11:30am",
        "resource_name": "Consultation Room 1",
        "person_name": "Waqas ",
        "datetime": "2017-03-10T11:30:00+00:00",
        "end_datetime": "2017-03-10T12:00:00+00:00",
        "duration": 30,
        "duration_span": 1800,
        "listed_duration": 30,
        "on_waitlist": false,
        "company_id": 50666,
        "attended": true,
        "price": 1500,
        "due_now": 0,
        "paid": 1500,
        "quantity": 1,
        "service_id": 104747,
        "purchase_id": 11610441,
        "purchase_ref": "IDXODKIPiQo321uMMTE2MTA0NDE%3D",
        "settings": {
          "obfuscated_id": "LOjmIDvhfgjzV_O5"
        },
        "min_cancellation_time": "2017-03-09T11:30:00+00:00",
        "service_name": "Microchipping",
        "time_zone": "Europe/London",
        "address": {
          "id": 52355,
          "name": "London Office",
          "address1": "111 Neville Road",
          "address2": "",
          "address3": "",
          "address4": "",
          "address5": "",
          "postcode": "E11 11",
          "country": "United Kingdom",
          "lat": 52.3284793,
          "long": 0.2788746,
          "map_url": "",
          "map_marker": "111+Neville+Road,+E11+11,+United+Kingdom",
          "phone": "",
          "homephone": "",
          "extra": {},
          "_links": {
            "self": {
              "href": "https://{host}.bookingbug.com/api/v1/50666/addresses/52355"
            }
          }
        },
        "booking_type": "Booking",
        "slot_id": 17336880,
        "first_name": "Test",
        "last_name": "Gladden",
        "email": "test@bookingbug.com",
        "_embedded": {
          "answers": [],
          "survey_answers": []
        },
        "_links": {
          "self": {
            "href": "https://{host}.bookingbug.com/api/v1/purchases/IDXODKIPiQo321uMMTE2MTA0NDE%3D/bookings/13477736"
          },
          "check_in": {
            "href": "https://{host}.bookingbug.com/api/v1/bookings/13477736/check_in"
          },
          "attachments": {
            "href": "https://{host}.bookingbug.com/api/v1/purchases/IDXODKIPiQo321uMMTE2MTA0NDE%3D/bookings/13477736/attach"
          },
          "person": {
            "href": "https://{host}.bookingbug.com/api/v1/50666/people/30553"
          },
          "resource": {
            "href": "https://{host}.bookingbug.com/api/v1/50666/resources/43049"
          },
          "service": {
            "href": "https://{host}.bookingbug.com/api/v1/50666/services/104747"
          },
          "company": {
            "href": "https://{host}.bookingbug.com/api/v1/company/50666"
          },
          "client": {
            "href": "https://{host}.bookingbug.com/api/v1/50666/client/3056937"
          },
          "member": {
            "href": "https://{host}.bookingbug.com/api/v1/50579/members/3056937{?embed}",
            "templated": true
          },
          "survey_questions": {
            "href": "https://{host}.bookingbug.com/api/v1/50666/32705/survey_questions{?admin_only}",
            "templated": true
          },
          "address": {
            "href": "https://{host}.bookingbug.com/api/v1/50666/addresses/52355"
          }
        }
      }
    ],
    "packages": [],
    "products": [],
    "pre_paid_bookings": [],
    "deals": [],
    "course_bookings": [],
    "external_purchases": [],
    "confirm_messages": [
      {
        "id": 76209,
        "message": "Booking Text for confirmation page",
        "message_type": "Confirm",
        "item_type": "Company",
        "_links": {
          "self": {
            "href": "https://{host}.bookingbug.com/api/v1/50666/booking_text/76209"
          },
          "item": {
            "href": "https://{host}.bookingbug.com/api/v1/company/50666"
          }
        }
      }
    ]
  },
  "_links": {
    "self": {
      "href": "https://{host}.bookingbug.com/api/v1/purchases/IDXODKIPiQo321uMMTE2MTA0NDE%3D"
    },
    "ical": {
      "href": "http://{host}.bookingbug.com/ical/total/IDXODKIPiQo321uMMTE2MTA0NDE%3D"
    },
    "web_cal": {
      "href": "webcal://{host}.bookingbug.com/ical/total/IDXODKIPiQo321uMMTE2MTA0NDE%3D"
    },
    "gcal": {
      "href": "http://www.google.com/calendar/event?dates=20170310T113000Z%2F20170310T120000Z&details=&location=Consultation+Room+1&sprop=www.bookingbug.com&text=Booking%3A+Microchipping+with+Waqas++at+Waqas+Ahmad+Child&trp=false&action=TEMPLATE"
    },
    "client": {
      "href": "https://{host}.bookingbug.com/api/v1/50666/client/3056937"
    },
    "member": {
      "href": "https://{host}.bookingbug.com/api/v1/50579/members/3056937{?embed}",
      "templated": true
    },
    "company": {
      "href": "https://{host}.bookingbug.com/api/v1/company/50666"
    },
    "bookings": {
      "href": "https://{host}.bookingbug.com/api/v1/purchases/IDXODKIPiQo321uMMTE2MTA0NDE%3D/bookings"
    },
    "packages": {
      "href": "https://{host}.bookingbug.com/api/v1/purchases/IDXODKIPiQo321uMMTE2MTA0NDE%3D/packages"
    },
    "pre_paid_bookings": {
      "href": "https://{host}.bookingbug.com/api/v1/purchases/IDXODKIPiQo321uMMTE2MTA0NDE%3D/pre_paid_bookings"
    },
    "products": {
      "href": "https://{host}.bookingbug.com/api/v1/purchases/IDXODKIPiQo321uMMTE2MTA0NDE%3D/products"
    },
    "deals": {
      "href": "https://{host}.bookingbug.com/api/v1/purchases/IDXODKIPiQo321uMMTE2MTA0NDE%3D/deals"
    },
    "confirm_messages": {
      "href": "https://{host}.bookingbug.com/api/v1/purchases/IDXODKIPiQo321uMMTE2MTA0NDE%3D/confirm_messages"
    },
    "book_waitlist_item": {
      "href": "https://{host}.bookingbug.com/api/v1/purchases/IDXODKIPiQo321uMMTE2MTA0NDE%3D/book_waitlist_item"
    },
    "external_purchases": {
      "href": "https://{host}.bookingbug.com/api/v1/purchases/IDXODKIPiQo321uMMTE2MTA0NDE%3D/external_purchases"
    },
    "print": {
      "href": "/angular/print_purchase.html?id=IDXODKIPiQo321uMMTE2MTA0NDE%3D&company_id=50666"
    },
    "paypal_express": {
      "href": "/pay/paypal_express/IDXODKIPiQo321uMMTE2MTA0NDE%3D{?landing_page,allow_guest_checkout,allow_note,logo_image,max_amount,no_shipping,allowed_payment_method}",
      "templated": true,
      "type": "location"
    }
  }
}