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
.
You can only call this method when authenticated as a Wix app or Wix user identity.
Events to create.
Whether to return created events.
Default: false
.
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.
The result for each event, containing the event and whether the action was successful.
Total successes and failures.
Creates multiple events.
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"
}
}
}
]
}'
{
"results": [
{
"itemMetadata": {
"id": "37e01b7f71374c06bca502eb435c1503b26e5434815a4e7ca6ac9be4783c5482",
"originalIndex": 0,
"success": true
}
},
{
"itemMetadata": {
"id": "37e01b7f71374c06bca502eb435c1503c0d77e8daef74681952c80b1bfd42d3d",
"originalIndex": 1,
"success": true
}
}
],
"bulkActionMetadata": {
"totalSuccesses": 2,
"totalFailures": 0
}
}
This method doesn’t return any custom errors, but may return standard errors. Learn more about standard Wix errors.