Operate on events that already exist. Creating an event — including its date, location, description, guest limit, ticket tiers and recurring occurrences — is Create an Event.
Every endpoint here returns 428 WIX_EVENTS_APP_NOT_INSTALLED against a site without the app.
Install it first — do not guess the install path:
appDefId nests under appInstance, not at the root — at the root it fails with
400 appInstance must not be empty. See Install Wix Apps.
Every action below takes an eventId. When the user names the event instead, look it up with
POST /events/v3/events/query — title supports $eq and, for several names at once, $in; there is
no contains match:
filter and paging are siblings under query; paging nested inside filter fails 400. Matches
come back in events[] with the id at events[].id, and pagingMetadata.total is the count.
Keep includeDrafts: false unless the user is asking about draft events. Setting it to true
needs WIX_EVENTS.READ_DRAFT_EVENTS, and a caller without it gets
403 Requires WIX_EVENTS.READ_DRAFT_EVENTS permission rather than more results — so do not flip
it as a precaution on an ordinary lookup, and do not probe for it and fall back. If the user does
want drafts and the call returns that 403, say draft events are not readable from this
connection instead of answering from published events alone.
| Action | Call | Resulting status |
|---|---|---|
| Publish a draft | POST /events/v3/events/{eventId}/publish | UPCOMING |
| Cancel | POST /events/v3/events/{eventId}/cancel | CANCELED |
| Delete | DELETE /events/v3/events/{eventId} | — |
| Delete several | POST /events/v3/bulk/events/delete-by-filter | — |
Publish and cancel take an empty body. Publishing is irreversible — a published event cannot
return to DRAFT. Cancelling closes registration but keeps the event; deleting removes it.
Publish, cancel, clone and update all return { "event": { "id", "title", "slug", "status", ... } }
— the same event object Create an Event shows in full.
Delete returns { "eventId": "..." } and the bulk delete below returns {}.
To delete a set of events in one call, POST /events/v3/bulk/events/delete-by-filter:
The request's one field, filter, takes a whole query-shaped object — the same object Query Events
takes under query, with the conditions under its own filter key — not a bare condition map. That
is why the key appears twice: filter.filter.<field>. A single level,
{ "filter": { "id": { "$in": [...] } } }, is not the documented shape. Resolve the ids with the
query above first; one DELETE per event also works but costs a call each.
Draft events need the WIX_EVENTS.READ_DRAFT_EVENTS permission. Without it, publishing a
draft fails 403 — as does querying it, fetching it by slug, or adding ticket definitions to
it. If you hit that 403, the event was still created; the way forward is to create events
already published rather than as drafts, which needs no publish step at all. See
Create an Event.
POST /events/v3/events/{eventId}/clone with an empty body copies the registration form,
notifications, translations and ticket configuration.
The clone does not keep the original's date. Its start date is reset to roughly 14 days from
now and it comes back as a DRAFT. For a duplicate on a particular date, follow the clone with
an update — and note the draft permission above.
PATCH /events/v3/events/{event.id} with the fields to change nested under event:
The Events API takes no field mask and no revision on update — send only the fields you are
changing. A revision, if you send one, is ignored rather than rejected.
When moving a date, send startDate and endDate together. dateAndTimeSettings is replaced
wholesale rather than merged, so a patch carrying only startDate leaves the event with no end and
fails 400 event cannot have negative duration — an error naming neither the missing field nor the
replacement. timeZoneId is optional here, unlike on create; the stored one is kept.
Ticket definitions are the exception — PATCH /events/v3/ticket-definitions/{ticketDefinition.id}
does require the current revision, which increments on every update.
POST /events/v3/events/query and read pagingMetadata.total:
Query Events returns only published events — drafts are excluded from both the results and the total, and including them needs the draft permission above. Create published, or publish first, if the count is meant to include the event you just made.
POST /events/v3/events/count-by-status exists, but an empty request body returns empty facets
even when the site has events, so it is not the way to answer "how many events do I have".
<field> value is required rather than "invalid value". If a field you did send is reported
as required, suspect the value, not its presence.includeDrafts stays false unless the request is about drafts — see
Find an event. The WIX_EVENTS.READ_DRAFT_EVENTS note on the Query Events
reference describes the permission; it does not mean the caller has it.{seconds, nanos}, and timeZoneId is required
whenever dateAndTimeSettings is sent — see Create an Event.POST /events/v2/guests/query — who registeredLast updated: 24 September 2026