cURL
Events
Book Event
Book a new Novacal event with the public API by sending the event type, selected time, attendee answers, timezone, and location data.
POST
cURL
This endpoint requires a public API bearer token.
The authenticated API key identifies the caller integration. The event booker is still created from the submitted booking payload, for example
form_field_answers.name and form_field_answers.email.
When to use this endpoint
Use this endpoint when you want to create a new booking from your own product, widget, or backend workflow. Common use cases include:- Creating a booking after a customer selects a time in your app
- Passing attendee answers collected in a custom booking flow
- Saving the selected timezone and meeting location in the same request
Authentication notes
This route uses a public API bearer token. The token authenticates your integration, while the attendee details still come from the booking payload you submit.Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
Event booking payload
The ID of the event type being booked
The requested event start date and time
The requested event end date and time
The booker's timezone
The booker's preferred time format
Available options:
12, 24 Optional selected location payload
Booking answers such as name, email, and any custom fields