Slotflow Documentation

Slotflow is scheduling infrastructure for AI agents. It provides a REST API that lets your AI agent check availability, book appointments, and manage the full booking lifecycle for real humans — without breaking the agent workflow.

How it works

Developer (you) → creates humans and sets availability
AI Agent (your product) → calls the Slotflow API to find slots and book them
End User (your customer) → gets booked into a time slot

The agent is the actor. The human’s availability is the resource. You are the customer.

Quick links

Core workflow

Every integration follows the same pattern:

1. Create humans — represent each person whose time can be booked (sales reps, support agents, recruiters)
2. Set availability — define working days, hours, and meeting durations for each human
3. Query slots — your agent calls GET /v1/humans/:id/slots to find available times
4. Book a slot — your agent calls POST /v1/bookings to confirm the appointment
5. Get notified — webhooks fire on booking.confirmed and booking.cancelled events

Why Slotflow

Built for agents, not humans clicking buttons. Existing scheduling tools (Calendly, Cal.com) are designed for humans interacting with UIs. Their APIs are afterthoughts. Slotflow is API-first — every feature is designed to be consumed by an autonomous agent.

One call for availability. Google Calendar and Outlook return raw events — your agent has to compute availability itself. Slotflow returns ready-to-book time slots in a single API call.

Metadata passthrough. Agents need to carry context through booking workflows (lead IDs, conversation IDs, ticket numbers). Slotflow lets you attach arbitrary JSON metadata to every booking, and it flows through to webhook payloads.

Plans

Sign up free to get started. No credit card required.