Organizations and the Marketplace
This page is for external organisations looking to join the Beds24 marketplace
Contents
1 Capabilities
Beds24 offers a marketplace for external organisations to easily connect with Beds24 users to provide services for them. Once a Beds24 user enables a connection to an organisation, the organisation can access the users Beds24 account by API function to perform their services. The available API functions are the same as the Beds24 API V2 functions https://api.beds24.com/v2
2 Getting Started
Contact Beds24 to establish a marketplace entry for your organisation. Organisations are only accepted at the discretion of Beds24. If your organisation is accepted you will be assigned an organisation token and an access token.
3 Authentication
Organisations will be whitelisted by function and scope and only able to access their whitelisted functions and scopes.
When calling an API function the organisation must include the organisation header token with every call.
The access token grants access to all Beds24 accounts which have enabled the organisation. The Beds24 account can specify which of their room types are available to the organisation and only these enabled room types will be visible.
When calling an API function to access property level data, the property ID must be included with the access token. The format is to use a trailing colon, then a lower case p and then the property ID all with no spaces.
For example an access token to access property ID 12345 could look like this:
abcdefghijklmnopqustuvwxyz:p12345
4 Connecting with Beds24 users
Your organisation will appear in our Apps and integrations marketplace menu. A beds24 user can find your organisation there and enable the room types they would like to make available to your organisation. These room types will then be available for your API calls.
The special function GET /organizations/users can be called to see all users who have enabled the connection to your organisation.
