Organizations and the Marketplace
This page is for external organizations looking to join the Beds24 marketplace
1 Capabilities
Beds24 offers a marketplace for external organizations to easily connect with Beds24 users to provide services for them. Once a Beds24 user enables a connection to an organization, the organization 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 organization. Organizations are only accepted at the discretion of Beds24. If your organisation is accepted you will be assigned an organization token and an access token.
3 Authentication
Organizations will be whitelisted by function and scope and only able to access their whitelisted functions and scopes.
When calling an API function the organization must include the organization header token with every call.
The access token grants access to all Beds24 accounts which have enabled the organization. The Beds24 account can specify which of their room types are available to the organization 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 organization will appear in our Apps and integrations marketplace menu. A beds24 user can find your organization there and enable the room types they would like to make available to your organization. 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 organization.
