PRproductive
Bookings

Create a booking

Changed on

Create a new booking.

post/api/v2/bookings

Request

  • Base URL
    https://developer.productive.io (the document declares no server; this is the origin it was published from)
  • URL
    https://developer.productive.io/api/v2/bookings
  • Auth
    none declared

Request body

Example request

{
  "data": {
    "type": "bookings",
    "attributes": {
      "person_id": 1234501,
      "service_id": 987654,
      "started_on": "2026-10-19",
      "ended_on": "2026-10-23",
      "booking_method_id": 1,
      "time": 480,
      "note": "Sprint 42 frontend work"
    }
  }
}

Response

Single booking

Example response

{
  "data": {
    "id": "1594",
    "type": "bookings",
    "attributes": {
      "hours": 8,
      "time": 480,
      "started_on": "2026-03-17",
      "ended_on": "2026-03-21",
      "total_time": 2400,
      "total_working_days": 5,
      "percentage": null,
      "note": null,
      "created_at": "2026-03-01T09:00:00.000+00:00",
      "updated_at": "2026-03-01T09:00:00.000+00:00",
      "people_custom_fields": {},
      "approved": false,
      "approved_at": null,
      "rejected": false,
      "rejected_reason": null,
      "rejected_at": null,
      "canceled": false,
      "canceled_at": null,
      "booking_method_id": 1,
      "autotracking": false,
      "draft": false,
      "custom_fields": null,
      "last_activity_at": "2026-03-01T09:00:00.000+00:00"
    },
    "relationships": {
      "person": {
        "data": {
          "type": "people",
          "id": "12"
        }
      },
      "service": {
        "data": {
          "type": "services",
          "id": "1856422"
        }
      },
      "event": {
        "data": null
      },
      "task": {
        "data": null
      }
    }
  },
  "included": []
}

Changes

  • fa3060fd0144Revision changes
    • warning

      added the new bad_decimal_format enum value to the // response property for the response status

    • warning

      added the new non_finite_number enum value to the // response property for the response status

    • warning

      added the new null_bytes_in_params enum value to the // response property for the response status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

  • 2551aa7f640eRevision changes
    • warning

      added the new booking_type_change_not_allowed enum value to the // response property for the response status