POST

Create Resource


Developer Preview

This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.

Creates a resource.

Bookings resources are created with a schedule. The schedule and its sessions determine the resource's availability. Note that the schedule must contain a start date in the availability.start property. For resources that are available during the business's default hours, add the business's schedule as a linked schedule in the resource's schedule. For resources that have their own hours, create sessions with type "WORKING_HOURS" using the resource's schedule. You can use both individual and recurring sessions to define resource availability. You cannot use availability constraints for resource schedules.

Use the following steps to create resources:

  • Create the resource using including schedule information.
  • If the resource uses the default business hours, get the business resource's schedule ID and include it in the scheduleInfo.availability.linkedSchedules array in the in the schedule parameters.
  • If the resource has its own custom working hours, create sessions of type "WORKING_HOURS". Use the scheduleId of the new resource when creating the sessions. These session can be single sessions or recurring sessions. You can have both business hours and custom hours for the same resource schedule.

Notes:

  • A resource can have one schedule only.
  • You can have up to 135 active resources and an additional 135 deleted resources.
  • The businessLocation.businessSchedule object in the schedule.location object is not supported.

Permissions: This endpoint requires the Manage Bookings permission scope.

Authentication

You can only call this method when authenticated as a Wix app or Wix user identity.

Permissions
Manage Bookings - all permissions
Manage Bookings
Learn more about app permissions.
Endpoint
POST
https://www.wixapis.com/_api/bookings/v1/resources

Event TriggersThis method triggers the following events:
Did this help?