Productive icon

Productive

Interact with the Productive API

Actions508

Bookings → Create a booking

AI-generated

Summary

Create a new booking in the Productive system by specifying the person, booking method, time, and optionally start and end datetimes along with related event or service IDs and a note.

Inputs

  • Person ID (required) — Numeric ID representing the person for whom the booking is created.
  • Started On — Optional start date and time for the booking.
  • Ended On — Optional end date and time for the booking.
  • Time (required) — Numeric value representing the amount of time for the booking.
  • Booking Method ID (required) — Numeric ID indicating booking method: 1 for hours per day (requires time attribute), 2 for percentage per day (requires percentage attribute set to 50 or 100), 3 for total time.
  • Event ID — Numeric ID required if creating a Timeoff/Event booking.
  • Service ID — Numeric ID required if creating a Service booking.
  • Note — Optional textual note to describe the booking.
  • Percentage (required) — Percentage of working hours, required if booking_method_id is 2, must be set to 50 or 100.

Output shape

a single record representing the created booking

The output contains data for the newly created booking item. If multiple inputs are provided, multiple records may be returned in an array.

Examples

Example 1: Create a booking of 8 hours for person ID 123, with booking method 1 (hours per day) starting at a specific datetime

Set Person ID to 123, Booking Method ID to 1, Time to 8, and optionally specify Started On and Ended On datetimes.

Discussion