# Novacal Docs

- [Introduction](https://docs.novacal.io/api-reference/introduction.md): Learn how the Novacal API works, how authentication is handled, and what to expect from requests and responses.
- [MCP](https://docs.novacal.io/api-reference/mcp.md): Connect Novacal to MCP-compatible clients using the hosted Novacal MCP server, enabling authenticated integration between Novacal and supported AI tools through a remote MCP endpoint.
- [Errors](https://docs.novacal.io/api-reference/errors.md): Understand Novacal API error responses, HTTP status codes, and the JSON error format returned when requests fail or validation does not pass.
- [Get Event Types](https://docs.novacal.io/api-reference/v1/event-types/get.md): List the Novacal event types available to the authenticated user, including names, durations, visibility settings, and form fields.
- [Create Event Type](https://docs.novacal.io/api-reference/v1/event-types/create.md): Create a new Novacal event type with settings for duration, availability, booking limits, buffers, redirects, and booking form fields.
- [Delete Event Type](https://docs.novacal.io/api-reference/v1/event-types/delete.md): Delete a Novacal event type by ID and review the endpoint path, authentication requirements, and no-content success response.
- [Update Event Type](https://docs.novacal.io/api-reference/v1/event-types/update.md): Update an existing Novacal event type and change scheduling rules, limits, colors, visibility, redirects, and related configuration.
- [Get Event Type](https://docs.novacal.io/api-reference/v1/event-types/find.md): Retrieve one Novacal event type by ID, including its scheduling settings, booking limits, visibility, and active booking form fields.
- [Get Booking Form Fields](https://docs.novacal.io/api-reference/v1/booking-forms/get.md): List all booking form fields for a Novacal event type, including labels, input types, placeholders, display order, and options.
- [Create Booking Form Field](https://docs.novacal.io/api-reference/v1/booking-forms/create.md): Create a new booking form field for a Novacal event type, including label, field type, placeholder, required state, and options.
- [Update Booking Form Field](https://docs.novacal.io/api-reference/v1/booking-forms/update.md): Update a Novacal booking form field and change its label, input type, placeholder, required state, active status, order, or options.
- [Delete Booking Form Field](https://docs.novacal.io/api-reference/v1/booking-forms/delete.md): Delete a booking form field from a Novacal event type by field ID and review the endpoint path, auth requirements, and success response.
- [Update Booking Form Field Order](https://docs.novacal.io/api-reference/v1/booking-forms/update-order.md): Reorder booking form fields for a Novacal event type by updating field positions in a single API request with ordered IDs.
- [Get Teams](https://docs.novacal.io/api-reference/v1/teams/get.md): List all Novacal teams the authenticated user belongs to and review the team data returned by the teams collection endpoint.
- [Get Team](https://docs.novacal.io/api-reference/v1/teams/find.md): Retrieve a single Novacal team by ID, including its name, username, branding details, and other team profile information.
- [Get Current User](https://docs.novacal.io/api-reference/v1/users/me.md): Retrieve the currently authenticated Novacal user, including profile details such as name, email, timezone, avatar, and time format.
- [Update Current User](https://docs.novacal.io/api-reference/v1/users/update-me.md): Update the authenticated Novacal user's profile, including username, email, name, avatar, timezone, week start, and time format.
- [Get Availability](https://docs.novacal.io/api-reference/v1/availability/get.md): Retrieve availability ranges for a Novacal event type across a selected date window so you can show bookable times in your app.
- [Get Slots](https://docs.novacal.io/api-reference/v1/slots/get.md): Retrieve bookable time slots for a Novacal event type, with duration, slot interval, buffers and minimum notice already applied.
- [Get Availabilities](https://docs.novacal.io/api-reference/v1/availabilities/get.md): List the availability schedules on your Novacal account, including their name, timezone, working days, and open hours.
- [Create Availability](https://docs.novacal.io/api-reference/v1/availabilities/create.md): Create a Novacal availability schedule with its own timezone and open hours, then point event types at it.
- [Get Availability Schedule](https://docs.novacal.io/api-reference/v1/availabilities/find.md): Retrieve one Novacal availability schedule by ID, with its timezone, working days, and open hours.
- [Update Availability](https://docs.novacal.io/api-reference/v1/availabilities/update.md): Change the name, timezone, or open hours of a Novacal availability schedule.
- [Delete Availability](https://docs.novacal.io/api-reference/v1/availabilities/delete.md): Delete a Novacal availability schedule and learn what happens to the event types that use it.
- [Get Events](https://docs.novacal.io/api-reference/v1/events/get.md): List the Novacal events the authenticated user can access, including scheduling details, attendees, hosts, and current event status.
- [Book Event](https://docs.novacal.io/api-reference/v1/events/create.md): Book a new Novacal event with the public API by sending the event type, selected time, attendee answers, timezone, and location data.
- [Get Event](https://docs.novacal.io/api-reference/v1/events/find.md): Retrieve a single Novacal event by ID and inspect its booking details, timing, status, organizer, guests, and submitted form answers.
- [Reschedule Event](https://docs.novacal.io/api-reference/v1/events/update.md): Reschedule an existing Novacal event with the public API by updating the start time, end time, timezone, and allowed booking answers.
- [Cancel Event](https://docs.novacal.io/api-reference/v1/events/cancel.md): Cancel an existing Novacal event with the API, including the required public authentication flow and optional cancellation reason payload.
- [Get Webhooks](https://docs.novacal.io/api-reference/v1/webhooks/get.md): List the webhooks registered on your Novacal account, including their target URL, subscribed events, signing secret, and active status.
- [Create Webhook](https://docs.novacal.io/api-reference/v1/webhooks/create.md): Register a Novacal webhook to receive real-time notifications when events are booked, rescheduled, or canceled, with a signing secret to verify deliveries.
- [Get Webhook](https://docs.novacal.io/api-reference/v1/webhooks/find.md): Retrieve a single Novacal webhook by ID to inspect its target URL, subscribed events, signing secret, and active status.
- [Update Webhook](https://docs.novacal.io/api-reference/v1/webhooks/update.md): Update a Novacal webhook to change its target URL, adjust which events it subscribes to, or pause deliveries without deleting it.
- [Delete Webhook](https://docs.novacal.io/api-reference/v1/webhooks/delete.md): Delete a Novacal webhook to permanently stop event deliveries to its endpoint.
- [Get Contacts](https://docs.novacal.io/api-reference/v1/contacts/get.md): List the contacts on your Novacal account, with search by name or email and pagination metadata.
- [Create Contact](https://docs.novacal.io/api-reference/v1/contacts/create.md): Add a contact to your Novacal account with a name, email, and timezone.
- [Get Contact](https://docs.novacal.io/api-reference/v1/contacts/find.md): Retrieve a single Novacal contact by ID.
- [Update Contact](https://docs.novacal.io/api-reference/v1/contacts/update.md): Update a Novacal contact's name, email, or timezone.
- [Delete Contact](https://docs.novacal.io/api-reference/v1/contacts/delete.md): Delete a contact from your Novacal account.

## OpenAPI Specs

- [openapi](/api-reference/openapi.json)