Bookings

Book a call with the coach's provider

Books an exact live slot from managed availability with the coach's calendar provider and invites the lead's email. The answer can still be pending while the provider confirms; read it again by id.

API key scopes: bookings:write. You also need an Idempotency-Key header.

post/api/bookings/provider-requests

Request

  • Base URL: https://api.setluca.com
  • URL: https://api.setluca.com/api/bookings/provider-requests
  • Auth: one of:
    • API key in cookie luca.session_token
    • API key in header x-api-key
    • HTTP bearer

Headers

idempotency-keystring required

Key that makes this mutation safe to retry. Replaying a key returns the original response with Idempotency-Replayed: true instead of acting twice.

Luca-API-Version'1'

The major version of the API this client was built against. Omit it and the request is served by the current major version. Any other value is refused with 400 unsupported_api_version.

Request body

leadIdstring uuid required
bookingTypeIdstring uuid required
slotIdstring required
startsAtstring date-time required
endsAtstring date-time required
timezonestring required
inviteeEmailstring email required
inviteeNamestring

Response

ok

idstring required
state'needs_input' | 'options' | 'accepted' | 'pending_provider' | 'confirmed' | 'handoff_required' | 'conflict' | 'failed' required
bookingIdstring
reasonstring
displayTextstring
finalStartsAtstring date-time
timezonestring
meetingUrlstring
managementUrlstring

Changes

No recorded changes to this operation across all 1 revision of this API.