POST

Bulk Create Event


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 multiple events in bulk.

If you provide recurrenceRule, an event with {"recurrenceType": "MASTER"} is created. Then, you can't set start.localDate to a past date, though the time can be earlier on the same day. You can, however, create single-occurrence events for past dates.

You can't create an event with recurrenceType set to INSTANCE or EXCEPTION. INSTANCE events are generated automatically based on the recurrence rule in the relevant MASTER event. EXCEPTION events are automatically created when you update an INSTANCE event, which changes its recurrenceType to EXCEPTION.

Authentication

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

Permissions
Manage Bookings - all permissions
Manage Bookings
Manage Calendars
Learn more about app permissions.
Endpoint
POST
https://www.wixapis.com/calendar/v3/bulk/events/create

Body Params
eventsArray <MaskedEvent>RequiredminItems 1maxItems 50

Events to create.


returnEntityboolean

Whether to return created events.

Default: false.


timeZonestring

Time zone in IANA tz database format for calculating adjustedStart and adjustedEnd. For example, America/New_York or UTC.

Default: timeZone specified in the business site properties.

Response Object
resultsArray <BulkEventResult>

The result for each event, containing the event and whether the action was successful.


bulkActionMetadataBulkActionMetadata

Total successes and failures.

Bulk Create Event

Creates multiple events.

Request
cURL
curl -X POST \ 'https://www.wixapis.com/calendar/v3/bulk/events/create' \ -H 'Content-Type: application/json' \ -H 'Authorization: <AUTH>' \ -d '{ "events": [ { "event": { "scheduleId": "eed85dfb-52af-42c1-9ca9-0b4ea84c5614", "title": "First Event", "start": { "localDate": "2025-01-01T10:00:00" }, "end": { "localDate": "2025-01-01T12:00:00" } } }, { "event": { "scheduleId": "aa4b4693-1fc3-424f-82f4-5b693b67506e", "title": "Second Event", "start": { "localDate": "2025-01-01T14:00:00" }, "end": { "localDate": "2025-01-01T16:00:00" } } } ] }'
Response
JSON
{ "results": [ { "itemMetadata": { "id": "37e01b7f71374c06bca502eb435c1503b26e5434815a4e7ca6ac9be4783c5482", "originalIndex": 0, "success": true } }, { "itemMetadata": { "id": "37e01b7f71374c06bca502eb435c1503c0d77e8daef74681952c80b1bfd42d3d", "originalIndex": 1, "success": true } } ], "bulkActionMetadata": { "totalSuccesses": 2, "totalFailures": 0 } }
Errors

This method doesn’t return any custom errors, but may return standard errors. Learn more about standard Wix errors.

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