POST

Bulk Update 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.

Updates multiple events in bulk.

When updating an event with {"recurrenceType": "INSTANCE"}, the recurrenceType automatically changes to EXCEPTION.

When updating an event with {"recurrenceType": "MASTER"}:

  • Past INSTANCE and EXCEPTION events remain unchanged.
  • For future INSTANCE events, all relevant fields are updated.
  • For future EXCEPTION events, only changes to the inheritedFields are applied, while other fields remain unchanged.
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/update

Body Params
eventsArray <MaskedEvent>RequiredminItems 1maxItems 50

Events to update.

Min: 1 event Max: 50 events


returnEntityboolean

Whether to return the updated events.

Default: false


participantNotificationParticipantNotification

Information about whether participants of the updated event are notified and the message they receive.


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 Update Event

Updates multiple events.

Request
cURL
curl -X POST \ 'https://www.wixapis.com/calendar/v3/bulk/events/update' \ -H 'Content-Type: application/json' \ -H 'Authorization: <AUTH>' \ -d '{ "events": [ { "event": { "id": "130o4ncdcmm8csGKUihodsF8Lnx5vQuUmP9uqeurIYireDpysq5nOxSIMvXKf80QrOXzc09i1GXRepTUj2L01bzmifAqWHwp2pTmmtR3TmHJx7Tv6ODrmgS", "totalCapacity": 11, "revision": "4" } }, { "event": { "id": "130o4ncdcmm8csGKUihodsF8Lnx5vQuUmP9uqeurIYireDpysq5nOxSIMvXKf80QrOXzc09i1GXRepTUj2L01bzmifAqWHwp2pTmnfTErblp9jEabOCXmxk", "resources": [ { "id": "91ce3170-9109-4d9e-bdb6-d2613691b4a2" } ], "revision": "2" } } ] }'
Response
JSON
{ "results": [ { "itemMetadata": { "id": "130o4ncdcmm8csGKUihodsF8Lnx5vQuUmP9uqeurIYireDpysq5nOxSIMvXKf80QrOXzc09i1GXRepTUj2L01bzmifAqWHwp2pTmmtR3TmHJx7Tv6ODrmgS", "originalIndex": 0, "success": true } }, { "itemMetadata": { "id": "130o4ncdcmm8csGKUihodsF8Lnx5vQuUmP9uqeurIYireDpysq5nOxSIMvXKf80QrOXzc09i1GXRepTUj2L01bzmifAqWHwp2pTmnfTErblp9jEabOCXmxk", "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?