Developers,developers,developers!
Alles in Makeplans zit in de API: REST en JSON, webhooks voor elke wijziging en een MCP-server voor AI-assistenten.
- REST + JSON
- Webhooks
- MCP
- iCal
- CSV
$ curl https://youraccount.makeplans.com/api/v1/services/42/slots?from=2026-11-19 \ -H 'Authorization: Bearer $MAKEPLANS_API_KEY' \ -H 'User-Agent: MyApp' \ -H 'Accept: application/json' [ { "slot": { "timestamp": "2026-11-19T10:30:00+01:00", "timestamp_end": "2026-11-19T11:30:00+01:00", "free": 1, "available_resources": [1, 2], "maximum_capacity": 2 } }, { "slot": { "timestamp": "2026-11-19T13:00:00+01:00", "timestamp_end": "2026-11-19T14:00:00+01:00", "free": 2, "available_resources": [1, 2], "maximum_capacity": 2 } } ] $ curl https://youraccount.makeplans.com/api/v1/bookings -X POST \ -H 'Authorization: Bearer $MAKEPLANS_API_KEY' \ -H 'User-Agent: MyApp' \ -H 'Accept: application/json' \ -d 'booking[service_id]=42' \ -d 'booking[resource_id]=1' \ -d 'booking[booked_from]=2026-11-19T10:30:00+01:00' \ -d 'booking[booked_to]=2026-11-19T11:30:00+01:00' { "booking": { "id": 1337, "state": "confirmed", "service_id": 42, "resource_id": 1, "booked_from": "2026-11-19T10:30:00+01:00", "booked_to": "2026-11-19T11:30:00+01:00" } }
curl https://youraccount.makeplans.com/api/v1/services/42/slots?from=2026-11-19 \ -H 'Authorization: Bearer $MAKEPLANS_API_KEY' \ -H 'User-Agent: MyApp' \ -H 'Accept: application/json'
[
{
"slot": {
"timestamp": "2026-11-19T10:30:00+01:00",
"timestamp_end": "2026-11-19T11:30:00+01:00",
"free": 1,
"available_resources": [1, 2],
"maximum_capacity": 2
}
},
{
"slot": {
"timestamp": "2026-11-19T13:00:00+01:00",
"timestamp_end": "2026-11-19T14:00:00+01:00",
"free": 2,
"available_resources": [1, 2],
"maximum_capacity": 2
}
}
]
# 10:30 is free. Book it.
curl https://youraccount.makeplans.com/api/v1/bookings -X POST \ -H 'Authorization: Bearer $MAKEPLANS_API_KEY' \ -H 'User-Agent: MyApp' \ -H 'Accept: application/json' \ -d 'booking[service_id]=42' \ -d 'booking[resource_id]=1' \ -d 'booking[booked_from]=2026-11-19T10:30:00+01:00' \ -d 'booking[booked_to]=2026-11-19T11:30:00+01:00'
{
"booking": {
"id": 1337,
"state": "confirmed",
"service_id": 42,
"resource_id": 1,
"booked_from": "2026-11-19T10:30:00+01:00",
"booked_to": "2026-11-19T11:30:00+01:00"
}
}
const api = "https://youraccount.makeplans.com/api/v1";
const headers = {
Authorization: `Bearer ${process.env.MAKEPLANS_API_KEY}`,
"User-Agent": "MyApp",
Accept: "application/json",
};
// Find the first free slot
const slots = await fetch(`${api}/services/42/slots?from=2026-11-19`, { headers })
.then((res) => res.json());
const { slot } = slots.find(({ slot }) => slot.free > 0);
// Book it
const booking = await fetch(`${api}/bookings`, {
method: "POST",
headers,
body: new URLSearchParams({
"booking[service_id]": "42",
"booking[resource_id]": String(slot.available_resources[0]),
"booking[booked_from]": slot.timestamp,
"booking[booked_to]": slot.timestamp_end,
}),
}).then((res) => res.json());
console.log(booking);
{
"booking": {
"id": 1337,
"state": "confirmed",
"service_id": 42,
"resource_id": 1,
"booked_from": "2026-11-19T10:30:00+01:00",
"booked_to": "2026-11-19T11:30:00+01:00"
}
}
require "net/http"
require "json"
API = "https://youraccount.makeplans.com/api/v1"
def makeplans(request)
request["Authorization"] = "Bearer #{ENV.fetch('MAKEPLANS_API_KEY')}"
request["User-Agent"] = "MyApp"
request["Accept"] = "application/json"
uri = request.uri
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(request) }
JSON.parse(response.body)
end
# Find the first free slot
slots = makeplans(Net::HTTP::Get.new(URI("#{API}/services/42/slots?from=2026-11-19")))
slot = slots.map { |s| s["slot"] }.find { |s| s["free"] > 0 }
# Book it
post = Net::HTTP::Post.new(URI("#{API}/bookings"))
post.set_form_data(
"booking[service_id]" => 42,
"booking[resource_id]" => slot["available_resources"].first,
"booking[booked_from]" => slot["timestamp"],
"booking[booked_to]" => slot["timestamp_end"]
)
puts makeplans(post)
{
"booking": {
"id": 1337,
"state": "confirmed",
"service_id": 42,
"resource_id": 1,
"booked_from": "2026-11-19T10:30:00+01:00",
"booked_to": "2026-11-19T11:30:00+01:00"
}
}
import os
import requests
API = "https://youraccount.makeplans.com/api/v1"
session = requests.Session()
session.headers.update({
"Authorization": f"Bearer {os.environ['MAKEPLANS_API_KEY']}",
"User-Agent": "MyApp",
"Accept": "application/json",
})
# Find the first free slot
slots = session.get(f"{API}/services/42/slots", params={"from": "2026-11-19"}).json()
slot = next(s["slot"] for s in slots if s["slot"]["free"] > 0)
# Book it
booking = session.post(f"{API}/bookings", data={
"booking[service_id]": 42,
"booking[resource_id]": slot["available_resources"][0],
"booking[booked_from]": slot["timestamp"],
"booking[booked_to]": slot["timestamp_end"],
}).json()
print(booking)
{
"booking": {
"id": 1337,
"state": "confirmed",
"service_id": 42,
"resource_id": 1,
"booked_from": "2026-11-19T10:30:00+01:00",
"booked_to": "2026-11-19T11:30:00+01:00"
}
}
In een paar minuten aan de slag
Haal je API-sleutel op
Schakel de API in onder Setup → Integrations → API en kopieer je sleutel.
Doe je eerste request
Stuur de sleutel mee als Bearer-token. Elk object heeft een eigen endpoint, alles in JSON.
Luister naar wijzigingen
Voeg een webhook toe en wij doen een POST naar je server wanneer boekingen, evenementen of klanten wijzigen.
Twee API's
Publieke API
Geen sleutel nodig. Toon diensten en beschikbare tijden en start een boeking, direct vanaf je website.
https://youraccount.makeplans.com/
Privé-API
Volledige toegang tot je account met een API-sleutel, voor je backend en integraties. Houd de sleutel buiten publieke code.
https://youraccount.makeplans.com/api/v1/
Koppel Makeplans aan je interne applicatie of website
Alle functies van Makeplans zijn beschikbaar via de API. Het is een REST-API met JSON. We kunnen ook webhooks versturen.
Koppel je AI-assistent (MCP)
Makeplans biedt een MCP-server, zodat AI-assistenten zoals Claude en ChatGPT met je boekingen kunnen werken. Vraag je assistent om de beschikbaarheid te controleren, een klant op te zoeken of boekingen aan te maken en te annuleren – met je eigen Makeplans-inloggegevens.
MCP (Model Context Protocol) is een open standaard. Elke assistent of agent die MCP spreekt, kan verbinding maken – geen speciale plug-in, geen lock-in, net zoals we al het andere bouwen.
Tools die je assistent krijgt
find_available_slotslist_serviceslist_eventslist_bookingsget_bookingfind_customercreate_bookingcancel_booking
Koppel Claude Code met één regel
claude mcp add --transport http makeplans \ https://youraccount.makeplans.com/api/mcp \ --header "Authorization: Bearer $MAKEPLANS_API_KEY"
Lees meer over onze AI-boekingsassistent.
Webhooks voor elke wijziging
Wordt een boeking aangemaakt, bevestigd, verplaatst of geannuleerd, dan sturen wij die met een POST naar je server, ondertekend met HMAC SHA-256 zodat je weet dat het bericht van ons komt. Zapier en Make kunnen het ook oppikken.
De standaard boekingspagina aanpassen
Je kunt de standaard boekingspagina aanpassen met eigen CSS. Daarnaast kun je formulieren aanpassen en alle uitgaande berichten met de templatetaal Liquid.
// Klik op een waarde om die te wijzigen
Ingebouwde integraties
Makeplans heeft al een flink aantal integraties ingebouwd. Kijk op onze integratiepagina voor meer informatie. Naast onze directe integraties koppelen we ook met de integratieplatformen Zapier en Make, waarmee je zonder te programmeren met andere applicaties kunt integreren.
Gegevens exporteren
Boekingen, klanten en evenementen kun je eenvoudig als CSV-bestand exporteren en downloaden.
iCalendar-feeds
Om afspraken uit Makeplans in andere agenda-apps te tonen, bieden we een iCalendar-feed. Die werkt met Google Calendar, Agenda voor macOS en iOS, Android, Outlook en andere agenda-apps.
Duik in de documentatie
Je vindt onze API-documentatie op developer.makeplans.com.