Quickstart

This guide takes you from zero to a confirmed booking in 5 minutes. By the end, you’ll have created a human, set their availability, found open slots, and booked one.

Prerequisites

• A Slotflow account (sign up free)
• Your API key (find it on the dashboard)

1. Create a human

Humans represent the real people whose time can be booked. Create one for each team member.

$
curl -X POST https://api.slotflow.dev/v1/humans \
>
  -H "Authorization: Bearer sk_live_your_api_key" \
>
  -H "Content-Type: application/json" \
>
  -d '{
>
    "name": "Sarah Chen",
>
    "email": "sarah@acme.com",
>
    "role": "sales_rep",
>
    "timezone": "America/New_York"
>
  }'

Save the id from the response — you’ll need it for every subsequent call.

2. Set availability

Define when this human is available for meetings. This sets their base weekly schedule.

$
curl -X PUT https://api.slotflow.dev/v1/humans/HUMAN_ID/availability \
>
  -H "Authorization: Bearer sk_live_your_api_key" \
>
  -H "Content-Type: application/json" \
>
  -d '{
>
    "working_days": [1, 2, 3, 4, 5],
>
    "work_start": "09:00",
>
    "work_end": "17:00",
>
    "meeting_durations": [30, 60]
>
  }'

• working_days: 1=Monday through 7=Sunday
• work_start / work_end: HH:MM format in the human’s timezone
• meeting_durations: array of allowed meeting lengths in minutes

3. Get available slots

This is the core endpoint. Your AI agent calls this to find when the human is free.

$
curl "https://api.slotflow.dev/v1/humans/HUMAN_ID/slots?date_from=2026-03-16&date_to=2026-03-20&duration=30" \
>
  -H "Authorization: Bearer sk_live_your_api_key"

The response includes all available 30-minute slots for the week. Times are in UTC — use the timezone field to convert for display.

4. Book a slot

Pick a slot from the response and book it.

$
curl -X POST https://api.slotflow.dev/v1/bookings \
>
  -H "Authorization: Bearer sk_live_your_api_key" \
>
  -H "Content-Type: application/json" \
>
  -d '{
>
    "human_id": "HUMAN_ID",
>
    "starts_at": "2026-03-16T14:00:00.000Z",
>
    "duration": 30,
>
    "attendee_name": "Alex Rivera",
>
    "attendee_email": "alex@startup.io",
>
    "metadata": {
>
      "source": "quickstart_guide"
>
    }
>
  }'

The booking is confirmed immediately. The slot is no longer available for other bookings.

5. Verify on the dashboard

Open the Slotflow Dashboard and navigate to Bookings. You should see your new booking with status “confirmed”.

What’s next?