For the complete documentation index, see llms.txt.

Onboarding

This guide walks you from a blank slate to your first confirmed booking via the API.

1. Sign up

Create an account at vennio.app.

2. Connect your calendar

Go to Dashboard → Connect Calendar and connect Google or Microsoft. This is required before the API can create bookings — Vennio checks your calendar to avoid conflicts.

3. Get an API key

Go to Dashboard → API Keys → Create API Key. Your key will look like vennio_sk_live_....

Keep this secret — it grants full access to your account.

4. Get your business_id

Your business_id is needed for availability queries and booking creation. Fetch it from the API:

curl https://api.vennio.app/v1/me \
  -H "Authorization: Bearer $VENNIO_API_KEY"

The response includes "principal_id": "your-business-id". Store this value.

5. Check availability

Query the API for open slots:

curl "https://api.vennio.app/v1/availability/slots?business_id=your-business-id&duration_minutes=30&from=2026-04-07T09:00:00Z&to=2026-04-07T17:00:00Z" \
  -H "Authorization: Bearer $VENNIO_API_KEY"

The response returns an array of { start, end } slot objects.

6. Create a booking

Pick a slot and create a booking:

curl -X POST https://api.vennio.app/v1/bookings \
  -H "Authorization: Bearer $VENNIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "business_id": "your-business-id",
    "customer_email": "customer@example.com",
    "customer_name": "Jane Doe",
    "start_time": "2026-04-07T10:00:00Z",
    "end_time": "2026-04-07T10:30:00Z"
  }'

A 201 response with the booking object means you're done.

Next steps