Blog Detail Title

Short Content Here

by Author Name

Date Published


We're going live!

Andrea Stubbe October 4, 2017

And we need to talk.

Apart from us being super happy and excited, this also means some changes for you, and us, and the way we work together.
If you already are working with apaleo APIs, here are the biggest changes for you:

  • the APIs will be available under
  • we'll start versioning the API. That gives us the possibility to roll out new features and API changes, without breaking your stuff.
  • we improved the security concept, as we'll now deal with real user data

What does this mean for you now?

All you'll need to do, is include the version in the path, like so: rest stays)
When you request an access token, specify either the scopes you want (find them in the API documentation), or just leave it blank - you will then get a token allowing to access all the APIs we opened up for you.
In addition, we started creating new clients for every customer, to ensure strict data separation. A new set of credentials will be sent to you soon. On your side, you'll need to use the right client when requesting access. For example, if you want to access the data of a customer 'Amazing Place', you'll need to get a token using the 'Amazing Place' client credentials.

What does this mean for you in the future?

We'll obviously continue rolling out new features and changing the API, but now that we have versioning in place, you can be sure that things don't suddenly break as long as you stay on the same version (and everyone: YEAH, no more breaking changes!)

However, keeping the previous versions around for too long will impact our speed to deliver new stuff (now everyone: OH NO!), which means they'll disappear after a while. More specifically, three months after we inform you about the change, and give you a guide and the possibility to migrate to the new stuff. If you cannot make it in time, ping us and we can see if we can extend that. We know that you also have other projects, and deadlines, and might not always be able to make the move within this timeframe.

For the impatient and curious, we will also make a sneak-preview version of the API available, coming with no guarantees, but the hottest new features and changes, some of them experimental. You'll find those under the version name 'nsfw', as they are 'not safe for work':

We'll keep you up to date about upcoming changes and new features, right here.

Thanks to all our partners and friends, for your trust and braveness to develop on apaleo, while it was still in a beta phase.
You are awesome.

Andrea Stubbe

Posted by

Andrea Stubbe
Andrea started coding as a kid, paused that for some years trying to find more interesting things, but then ended up doing that for a living. After working as a freelancer, researcher, teacher, and a normal employee in small and giant corporations, she fulfilled her childhood dream and co-founded a company a year ago. Being a fan of microservices since before she knew that term, she’s still contemplating how and if to use them in micro-sized companies.


by Benjamin Schmid


IBE Integration Guide

Let's talk Internet Booking Engines (IBEs). They work best when directly connected to the PMS, without any intermediaries that might get in the way with delays ...

by Andrea Stubbe


Digital guest journey with apaleo

apaleo is building software for hotels, and our users are people that work at hotels. To create amazing guest experiences we need you, creators of guest facing ...

by Andrea Stubbe


Push it! Webhooks in apaleo

The notification service allows you to build or set up apps which subscribe to certain events on apaleo (webhooks). When an event is triggered, we send an HTTP ...


Subscribe to our a-list for all the fun:

  • Keep up to date with hotel trends
  • Understand what matters most to hotel clients
  • Sweet gifs and special offers

Get it in your inbox every Monday ;)

By entering your email you expressly consent to receive our newsletter every week and other material related to...