API v1 live

Scheduling infrastructure for AI agents

One API call to check availability and book a slot. Built for developers whose AI agents need to schedule real humans.

book-a-demo.ts
import { SlotflowClient } from 'slotflow';
const client = new SlotflowClient({ token: 'sk_live_9f8g...' });
// Find available slots for your sales rep
const { slots } = await client.slots.getAvailableSlots({
humanId: 'hu_8xk2f', date_from: '2026-03-10', date_to: '2026-03-14', duration: 30
});
// Book the first available slot
const booking = await client.bookings.createBooking({
human_id: 'hu_8xk2f',
starts_at: slots[0].starts_at,
duration: 30,
attendee_name: 'Sarah Miller'
});

Everything your agent needs

A complete scheduling API. No UI widgets, no iframes, no human in the loop.

Pre-computed slots

One GET request returns available time slots. No calendar math. No timezone bugs. Ready for your agent to parse and act on.

Book in one request

POST a booking and get a confirmed slot back. Race condition protection built in — if two agents grab the same slot, one gets a clean 409.

Webhook notifications

Get notified instantly when bookings are confirmed or cancelled. Automatic retries. Your agent stays in the loop without polling.

Metadata passthrough

Attach arbitrary JSON to any booking. Lead IDs, conversation IDs, agent context — pass it in, get it back in webhooks.

Schedule overrides

Block a two-week vacation in one call. Open Saturday evenings for overtime. Set recurring blocks for team standups. Date ranges, time windows, recurring patterns — your agent handles it all.

Built for agents

REST API with JSON responses, ISO 8601 timestamps, and predictable error codes. No UI. No redirects. Pure infrastructure.

Three API calls. That's it.

Your agent goes from "find a time" to "meeting booked" without leaving its workflow.

1

Create a human

Register the person whose time gets booked. Set their timezone, working hours, and meeting durations.

POST /v1/humans

{
  "name": "John Smith",
  "timezone": "America/New_York"
}
2

Query available slots

Your agent asks for open time slots. Slotflow computes availability, filters conflicts, and returns clean JSON.

GET /v1/humans/hu_8xk2f/slots
    ?date_from=2026-03-10
    &date_to=2026-03-14
    &duration=30
3

Book the slot

Your agent picks a slot and books it. Slotflow confirms the booking and fires a webhook to your endpoint.

POST /v1/bookings

{
  "human_id": "hu_8xk2f",
  "starts_at": "2026-03-10T14:00:00Z",
  "duration": 30,
  "attendee_name": "Sarah Miller"
}

Install and ship

First-class SDKs so your agent can book meetings in 3 lines of code.

Node.js / TypeScript
Live
$ npm install slotflowv0.1.0
import { SlotflowClient } from "slotflow";

const client = new SlotflowClient({
  token: "sk_live_..."
});

const { slots } = await client.slots.getAvailableSlots(...);
const booking = await client.bookings.createBooking(...);
View SDK docs →
Python
Live
$ pip install slotflowv0.1.0
from slotflow import Slotflow

client = Slotflow(api_key="sk_live_...")

slots = client.slots.list(...)
booking = client.bookings.create(...)
View SDK docs →

Built for agent workflows

Wherever an AI agent needs to put a human in a time slot, Slotflow is the infrastructure layer.

AI sales agents

Lead comes in at 2am. Your agent qualifies them, sees your rep is on vacation next week but free Thursday at 3pm, and books the demo. Nobody woke up.

GET /v1/humans/hu_sales01/slots

AI recruiting tools

Candidate replies 'yes' to the interview. Your agent finds a slot that works around the hiring manager's recurring team standup and books it instantly.

POST /v1/bookings

Support escalation

AI handles the easy tickets. When it can't, it checks which support engineer is available — respecting their blocked hours and overtime slots — and books a callback.

GET /v1/humans/hu_support/slots

AI assistants

Your AI assistant knows your team's real availability — base schedules, time-off, even extra Saturday hours. It books meetings without a single calendar conflict.

POST /v1/bookings

Simple, usage-based pricing

Start free. Pay when your agents go to production. No credit card required.

Free

For testing and prototyping

$0/month
100 bookings/month
  • 1 human
  • 2 webhook endpoints
  • All API endpoints
  • Community docs
Get started free
Most popular

Starter

For shipping to production

$79/month
1,000 bookings/month
  • 5 humans
  • 10 webhook endpoints
  • Overage packs available
  • Email support
Get started

Growth

For scaling agent workflows

$299/month
10,000 bookings/month
  • 25 humans
  • Unlimited webhooks
  • Overage packs available
  • Priority email support
Get started

Need more? Talk to us about Enterprise — custom limits, dedicated support, SLAs.

Need more bookings? Paid plans include automatic overage packs — $19 per 500 additional bookings. Your agents never hit a wall in production.

Your agent can book meetings.
Right now.

Get your API key and make your first booking in under 10 minutes. Free plan. No credit card.