Category:API V2 - Revision history

Sorenjensen: /* Booking webhooks */

2026-06-12T10:09:49Z

Booking webhooks

← Older revision		Revision as of 10:09, 12 June 2026
Line 500:		Line 500:
	= Webhooks =		= Webhooks =
	== Booking webhooks ==		== Booking webhooks ==
	To ~~access~~ booking webhooks for API V2 ~~please contact support. They~~ can ~~then~~ be enabled under Settings > Properties > Access > Booking webhooks.		To enable the booking webhooks for API V2, they can be enabled under Settings > Properties > Access > Booking webhooks.

	== Other webhooks ==		== Other webhooks ==
	Information about other webhooks (including non API V2 webhooks) can be found here [https://wiki.beds24.com/index.php/Category:Webhooks Webhooks]		Information about other webhooks (including non API V2 webhooks) can be found here [https://wiki.beds24.com/index.php/Category:Webhooks Webhooks]

Ricarda at 20:11, 19 May 2026

2026-05-19T20:11:45Z

← Older revision		Revision as of 20:11, 19 May 2026
Line 8:		Line 8:


	API V1 is ~~depreciated~~, we do not recommend using it for new projects. Information about API V1 can be found here https://wiki.beds24.com/index.php/Category:API		API V1 is deprecated, we do not recommend using it for new projects. Information about API V1 can be found here https://wiki.beds24.com/index.php/Category:API

	= Authentication =		= Authentication =

Sorenjensen: /* What is the API credit limit? */

2025-12-29T13:25:23Z

What is the API credit limit?

← Older revision		Revision as of 13:25, 29 December 2025
Line 573:		Line 573:

	If you go over this limit you will not be able to make additional API calls until the 5 minute period is over.		If you go over this limit you will not be able to make additional API calls until the 5 minute period is over.

			You can increase this limit by contacting the support team through our ticketing system and it will cost 10€ per month to get the limit increased to 200 credits per 5 minutes, this limit can be changed/increased as much as you need.

	==Where can I see my API credit limit?==		==Where can I see my API credit limit?==

Sorenjensen: /* What is the API credit limit? */

2025-12-29T13:22:16Z

What is the API credit limit?

← Older revision		Revision as of 13:22, 29 December 2025
Line 568:		Line 568:

	==What is the API credit limit?==		==What is the API credit limit?==
	The API credit limit restricts how much you can use the API in a 5 minute window.		The API credit limit restricts how much you can use the API in a 5 minute window, it's by default 100 credits per 5 minutes.

	Each API request has a cost, this cost is calculated dynamically and depends on how complex the request is.		Each API request has a cost, this cost is calculated dynamically and depends on how complex the request is.

Sorenjensen at 10:37, 24 November 2025

2025-11-24T10:37:16Z

← Older revision		Revision as of 10:37, 24 November 2025
Line 632:		Line 632:

	In addition, there is a limit of 10000 top level JSON array item per POST request.		In addition, there is a limit of 10000 top level JSON array item per POST request.

			==Channel management only through the API==
			Please contact the Beds24 support team and open a ticket with your questions about using only the channel management through the API.

	==Where can I see the possible values for a booking's apiSourceId (API Source ID)==		==Where can I see the possible values for a booking's apiSourceId (API Source ID)==

Annette at 19:14, 17 September 2025

2025-09-17T19:14:04Z

← Older revision		Revision as of 19:14, 17 September 2025
Line 537:		Line 537:
	=FAQ=		=FAQ=
	==How do I access API V2?==		==How do I access API V2?==
	Create an invite code under {{#fas:cog}} (SETTINGS) ~~Apps & Integrations~~ > API.		Create an invite code under {{#fas:cog}} (SETTINGS) MARKETPLACE > API.

	Exchange this invite code for a refresh token and token using the POST /authentication/setup endpoint.		Exchange this invite code for a refresh token and token using the POST /authentication/setup endpoint.

Sorenjensen: /* POST /bookings */

2025-08-01T11:59:27Z

POST /bookings

← Older revision		Revision as of 11:59, 1 August 2025
Line 266:		Line 266:
	Create or update bookings.		Create or update bookings.

			==== How to Add/remove bookings from a group booking ====
	How to Add/remove bookings from a group booking

	You can add or remove a booking from a group booking by using the parameter "masterId" without having to use the action "makeGroup"		You can add or remove a booking from a group booking by using the parameter "masterId" without having to use the action "makeGroup"
Line 273:		Line 272:
	To add a booking to a group booking, you set the master id of the group booking in the "masterId" parameter so it would look like this in your request: "masterId": 1234567, that will modify the booking to add it to the group.		To add a booking to a group booking, you set the master id of the group booking in the "masterId" parameter so it would look like this in your request: "masterId": 1234567, that will modify the booking to add it to the group.

	To remove a booking from a group booking, you set the "masterId" parameter to null so it will look like this in your request: "masterId": null,		To remove a booking from a group booking, you set the "masterId" parameter to null so it will look like this in your request: "masterId": null.



			==== Using the stripeToken Field to Enable Stripe Payment Actions ====

			For direct bookings where payment is processed via Stripe, the stripeToken field must be set. This token is typically generated when collecting card details securely through Stripe, ensuring that sensitive information is not handled or stored by Beds24.

			If the stripeToken is present in a booking, a Stripe button will appear in the Charges and Payments tab. Clicking this button allows you to view Stripe transactions and access all saved cards associated with the booking.

			For bookings paid through other methods, this field remains empty unless card details are later collected via Stripe.

	=== DELETE /bookings ===		=== DELETE /bookings ===

Sorenjensen: /* POST /properties */

2025-04-11T10:03:34Z

POST /properties

← Older revision		Revision as of 10:03, 11 April 2025
Line 349:		Line 349:

	Create or modify properties.		Create or modify properties.

			Note: To update room-level settings, you must include the property id in your request. If it is missing, the system may return an error or incorrectly report success without applying any changes.


	==== Price rules ====		==== Price rules ====

Annette at 09:52, 7 April 2025

2025-04-07T09:52:29Z

← Older revision		Revision as of 09:52, 7 April 2025
Line 1:		Line 1:
	[[Category:API]]		[[Category:API]]

	This page explains the capabilities of API V2 and explains how to use it.		This page explains the capabilities of API V2 and explains how to use it.

Annette at 09:52, 7 April 2025

2025-04-07T09:52:19Z

← Older revision		Revision as of 09:52, 7 April 2025
Line 1:		Line 1:
	[[Category:API]]		[[Category:API]]

	~~<div class="heading">API Version 2</div>~~

	This page explains the capabilities of API V2 and explains how to use it.		This page explains the capabilities of API V2 and explains how to use it.