Bookeo Setup

You need the following to set up the Bookeo Connector in Cyclr:

  • A Bookeo application and the secret key associated with it.
  • An API key, generated when your Bookeo application is installed within a Bookeo account.

Obtaining a Secret Key

You can find Bookeo’s guide on how to register an application to get a secret key here under the Registering your application section.

Setting Permissions

Once you have created an application, use the Authorisation URL to allow clients to install your Bookeo application to their Bookeo account.

The Cyclr Bookeo Connector requires the following permissions to function:

  • customers_r_all
  • bookings_r_all
  • payments_r_all

Multiple permissions should be entered as a comma separated list.

An Authorisation URL for a Bookeo application for Cyclr has the following format:
signin.bookeo.com/?authappid=XYZ&permissions=customers_r_all,bookings_r_all,payments_r_all

Obtaining an API Key

Clients install your Bookeo application to their account using the authorization URL obtained in the previous section.

You can find Bookeo’s guide on how to get an API key here under the Obtaining user authorization for your application section.

Cyclr Setup

You will be asked for the following values when installing a Bookeo Connector:

ValueDescription
API KeyThe API key of your client’s Bookeo account.
Secret KeyThe secret key of your Bookeo application, if you did not enter this in step 5 above.