Bookpetal API v1

Build custom scheduling experiences with the Bookpetal REST API. Create bookings, manage availability, and sync data with your systems.

Base URL

https://api.bookpetal.com/v1

Authentication

All API requests require a Bearer token. Generate your API key from Settings → API Keys in your dashboard.

curl -H "Authorization: Bearer bp_live_xxxxx" \
  https://api.bookpetal.com/v1/event-types

List Event Types

GET /v1/event-types

Response:
{
  "data": [
    {
      "id": "evt_abc123",
      "name": "30 Minute Meeting",
      "duration": 30,
      "color": "#2563eb",
      "active": true
    }
  ]
}

Get Available Slots

GET /v1/availability?event_type=evt_abc123&date=2026-01-15

Response:
{
  "slots": [
    { "start": "2026-01-15T09:00:00Z", "end": "2026-01-15T09:30:00Z" },
    { "start": "2026-01-15T10:00:00Z", "end": "2026-01-15T10:30:00Z" }
  ]
}

Create a Booking

POST /v1/bookings
{
  "event_type_id": "evt_abc123",
  "start_time": "2026-01-15T10:00:00Z",
  "invitee": {
    "name": "Jane Smith",
    "email": "jane@example.com"
  }
}

Rate Limits

Free plans: 100 requests/minute. Professional: 1,000 requests/minute. Teams: 10,000 requests/minute.