Developers
Everything the apps do is available over the REST API, to AI agents over MCP, and to your systems as signed webhooks. The OpenAPI description is at /api/v1/openapi.json.
Authentication
- Organization API keys (
ab_…): create them in Developers, choose scopes. SendAuthorization: Bearer ab_…. - Apps: sign in through AuthPermit in the browser; the app receives a one-time code at
actionablebooking://authand exchanges it atPOST /api/v1/auth/tokenfor an access and refresh pair. Refresh tokens rotate. - AI agents (
ab_agent_…): a person grants an agent specific scopes for a limited time from Settings → AI agents.
Scopes: calendar:readcalendar:writebooking:readbooking:writeevent:readevent:writeavailability:readmessage:sendconversation:readresource:readresource:manageservice:managepayment:readwallet:paywebhook:managebrain:useknowledge:readtransport:readorg:readcustomer:readcustomer:write
MCP for AI agents
Point any MCP client at https://actionablebooking.com/mcp (JSON-RPC 2.0 over HTTP, initialize, tools/list, tools/call). Tools:
search_calendars— List the calendars the user can see, and optionally their events in a time range.get_availability— Free/busy for the user (and optionally other people by user id) and common free slots of a given length.find_booking_slots— Bookable slots for a service (restaurant table, appointment, room, class, rental) between two dates.search_places— Find bookable places (restaurants, clinics, hotels, venues) by text, category and map area, via Actionable Booking and GuiderMaps.create_booking— Book a slot of a service for the user. Returns the booking and, when payment is required, a checkout URL.modify_booking— Reschedule a booking to a new start time.cancel_booking— Cancel a booking (subject to the provider's cancellation policy).get_booking_status— Status, time, payment state and location of a booking, by id or confirmation code.create_event— Create a calendar event in the user's default (or given) calendar.invite_participants— Invite people (by email) to an event.get_event_details— Full details of an event: time, place, meeting link, attendees and their responses, transit.send_event_message— Post a message in an event's chat room.broadcast_event_message— Send one message to every participant of an event (in-app, push, email; optionally SMS/WhatsApp). Organizers only.start_meeting— Create (or return) the video meeting link for an event and start a call in its room.get_transport_schedule— Live transport information via TeleTransit: a flight by carrier+number+date, or departures from a stop.process_payment— Start payment for a booking awaiting payment; returns a Malaleem checkout URL for the user to approve.get_notification_preferences— The user's notification channels per category.update_notification_preferences— Change which channels a notification category uses.search_knowledge— What the platform knows about the user's relationships and habits: frequent places, people, services.list_business_bookings— The organization's bookings for a day or a few days (front desk view), in its time zone. Needs booking:manage in the organization.manage_business_booking— Act on one of the organization's bookings: confirm, reject, check_in, complete, no_show or cancel.list_business_services— The organization's services (what customers can book), including paused (draft) ones.save_business_service— Create a service for the organization, or change one (service_id): name, duration, price in minor units, status active/draft (paused)/archived.
curl -s https://actionablebooking.com/mcp -H "authorization: Bearer ab_agent_…" -H "content-type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"find_booking_slots","arguments":{"query":"dentist","date":"tomorrow"}}}'
Webhooks
Add endpoints in Developers and pick event types (booking.*, calendar_event.*,
payment.succeeded, …). Each delivery carries x-ab-signature: t=<unix>,v1=<hex hmac-sha256 of "t.body">,
signed with the endpoint's secret, and is retried with backoff for 24 hours.
Partner booking protocol
External booking systems can appear on the map and in the assistant by implementing five HTTPS calls —
POST /search, GET /availability, POST /quote,
POST /reservations, and POST /reservations/:id/confirm|cancel — signed with the shared secret issued at registration.
Embed a booking page
<script src="https://actionablebooking.com/assets/js/embed.js" data-ab-book="your-business/haircut" defer></script>
Room displays, locks and terminals
Register a device in Business → Resources to get its token, then call GET /device/v1/schedule,
poll GET /device/v1/commands (or join the /device-socket), acknowledge with
POST /device/v1/commands/:id/ack and check guests in with POST /device/v1/check-in.
Integrations
Calendars (Google, Microsoft 365, iCloud, CalDAV), video (native rooms, Zoom, Google Meet, Teams, Telemeet), CRM (HubSpot, Salesforce), Slack, and payments (Malaleem, Stripe, PayPal) are connected from Business settings.