How-to guides›Create your first booking
Create your first booking
This guide walks you end-to-end from an API key to a booked job request in five steps.
1
Get your API key
Create a sandbox key under Settings → Developers in your dashboard. It starts with chsk_test_ and is shown once at creation.
2
Find or create the customer
Look the customer up, or create one if they don’t exist yet — full_name plus at least one of phone/email is required.
curl -X POST "https://api.crisphive.com/v1/customers" \ -H "Authorization: Bearer chsk_test_4eC8xQ9mZ2pL7Ka0rT" \ -H "Content-Type: application/json" \ -d '{"full_name":"Lamar Bakery","email":"hello@lamarbakery.example"}'
3
Pick a job type
List your catalog to grab the job_type_id that classifies the work.
GET /v1/job-types
4
Check availability
Fetch bookable windows for the customer’s dates. The X-Timezone header is required.
curl "https://api.crisphive.com/v1/job-requests/booking-windows?from=2026-07-02&to=2026-07-09" \ -H "Authorization: Bearer chsk_test_4eC8xQ9mZ2pL7Ka0rT" \ -H "X-Timezone: America/Toronto"
5
Create the job request
Post the booking with one or more requested date windows, then track it via GET /v1/job-requests/{id} or the sync feed.
curl -X POST "https://api.crisphive.com/v1/job-requests" \ -H "Authorization: Bearer chsk_test_4eC8xQ9mZ2pL7Ka0rT" \ -H "Content-Type: application/json" \ -d '{"customer_id":"9b2f6c3e-…","job_type_id":"5d1b3a9e-…","job_dates":[{"date":"2026-07-02","periods":[{"period":"morning"}]}]}'