POST

Create Event


Creates an event.

The event includes a default registration form in the selected language, which consists of input fields for first name, last name, and email. See Registration Form for more information.

You can create the event as a draft by setting the draft value to true. Otherwise, the event is published right away.

The event is automatically set up to send daily summary reports of new guests to your business email.

Authentication

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

Permissions
Manage Events - all permissions
Manage Events
Learn more about app permissions.
Endpoint
POST
https://www.wixapis.com/events/v3/events

Body Params
eventEventRequired

Event data.


draftboolean

Whether to create the event as a draft.


fieldsArray <string>maxItems 20

Predefined sets of fields to return.

Response Object
eventEvent

Created event.

Request
cURL
curl -X POST 'https://www.wixapis.com/events/v3/events' \ -H 'Content-Type: application/json' \ -H 'Authorization: <AUTH TOKEN>' \ -d '{ "event": { "location": { "name": "Royal Albert Hall", "type": "VENUE", "address": { "country": "GB", "city": "London", "streetAddress": { "number": "SW7", "name": "Kensington Gore" } } }, "dateAndTimeSettings": { "dateAndTimeTbd": true, "dateAndTimeTbdMessage": "The date is yet to be defined. Stay tuned!" }, "title": "Nature Symphony: A Musical Journey Through Wildlife", "description": { "nodes": [ { "type": "PARAGRAPH", "id": "70zrx108", "nodes": [ { "type": "TEXT", "id": "", "textData": { "text": "Immerse yourself in the breathtaking beauty of nature through the universal language of music at " } }, { "type": "TEXT", "id": "", "textData": { "text": "Nature Symphony: A Musical Journey Through Wildlife", "decorations": [ { "type": "ITALIC", "italicData": true } ] } }, { "type": "TEXT", "id": "", "textData": { "text": ". This enchanting event combines the power of live orchestral performances with stunning visual projections of wildlife and natural landscapes from around the world." } } ] }, { "type": "PARAGRAPH", "id": "bgewn109" } ] }, "languageCode": "en", "registration": { "initialType": "TICKETING", "tickets": { "ticketLimitPerOrder": "30", "currency": "GBP", "taxSettings": { "type": "INCLUDED_IN_PRICE" } } } }, "draft": true, "fields": ["DETAILS", "TEXTS", "REGISTRATION", "URLS", "FORM", "DASHBOARD", "ONLINE_CONFERENCING_SESSION", "SEO_SETTINGS", "AGENDA", "CATEGORIES"] }'
Response
JSON
{ "event": { "id": "c241e6e2-c951-440d-8b62-52a6ec382140", "location": { "name": "Royal Albert Hall", "type": "VENUE", "address": { "country": "GB", "subdivision": null, "city": "London", "postalCode": "SW7 2BL", "streetAddress": { "number": "SW7", "name": "Kensington Gore", "apt": "", "formattedAddressLine": null }, "addressLine_2": null, "formattedAddress": "Kensington Gore, London SW7, UK", "hint": null, "geocode": { "latitude": 51.5009132, "longitude": -0.1766086 }, "countryFullname": "United Kingdom", "subdivisions": [ { "code": "England", "name": "England", "type": "ADMINISTRATIVE_AREA_LEVEL_1", "typeInfo": null }, { "code": "Greater London", "name": "Greater London", "type": "ADMINISTRATIVE_AREA_LEVEL_2", "typeInfo": null }, { "code": "GB", "name": "United Kingdom", "type": "COUNTRY", "typeInfo": null } ], "subdivisionFullname": null }, "locationTbd": false }, "dateAndTimeSettings": { "dateAndTimeTbd": true, "dateAndTimeTbdMessage": "The date is yet to be defined. Stay tuned!", "startDate": null, "endDate": null, "timeZoneId": null, "hideEndDate": false, "showTimeZone": false, "recurrenceStatus": "ONE_TIME", "recurringEvents": { "individualEventDates": [], "categoryId": null }, "formatted": { "dateAndTime": "The date is yet to be defined. Stay tuned!", "startDate": null, "startTime": null, "endDate": null, "endTime": null } }, "title": "Nature's Symphony: A Musical Journey Through Wildlife", "shortDescription": "Immerse yourself in the enchanting harmony of nature's symphony as it intertwines with the power of music!", "description": { "nodes": [ { "type": "PARAGRAPH", "id": "70zrx108", "nodes": [ { "type": "TEXT", "id": "", "textData": { "text": "Immerse yourself in the breathtaking beauty of nature through the universal language of music at " } }, { "type": "TEXT", "id": "", "textData": { "text": "Nature Symphony: A Musical Journey Through Wildlife", "decorations": [ { "type": "ITALIC", "italicData": true } ] } }, { "type": "TEXT", "id": "", "textData": { "text": ". This enchanting event combines the power of live orchestral performances with stunning visual projections of wildlife and natural landscapes from around the world." } } ] }, { "type": "PARAGRAPH", "id": "bgewn109" } ] }, "mainImage": null, "slug": "natures-symphony-a-musical-journey-through-wildlife", "languageCode": "en", "createdDate": "2023-07-13T12:52:00.911Z", "updatedDate": "2023-07-13T12:52:01Z", "status": "DRAFT", "registration": { "type": "TICKETING", "status": "CLOSED_AUTOMATICALLY", "rsvp": { "responseType": "YES_ONLY", "limit": null, "waitlistEnabled": false, "startDate": null, "endDate": null }, "tickets": { "guestsAssignedSeparately": false, "ticketLimitPerOrder": 30, "stockManagerAppId": null, "currency": null, "lowestPrice": null, "highestPrice": null, "soldOut": true, "taxSettings": null }, "external": null, "allowedGuestTypes": "VISITOR_OR_MEMBER", "initialType": "TICKETING", "registrationPaused": false, "registrationDisabled": false }, "calendarUrls": { "google": "http://calendar.google.com/calendar/render?action=TEMPLATE&text=Nature%27s+Symphony%3A+A+Musical+Journey+Through+Wildlife&dates=&location=Kensington+Gore%2C+London+SW7%2C+UK&details=Thank+you+for+registering+to+our+event%21+Your+tickets+are+attached+to+this+email.+Don%27t+forget+to+bring+them.%0A%0AWe%27re+looking+forward+to+seeing+you+there.%0A%0AHere+are+the+details%3A%0A%0ANature%27s+Symphony%3A+A+Musical+Journey+Through+Wildlife%0AThe+date+is+yet+to+be+defined.+Stay+tuned%21%0ARoyal+Albert+Hall%2C+Kensington+Gore%2C+London+SW7%2C+UK", "ics": "https://www.wixevents.com/media/v2/calendar?token=JWS.eyJraWQiOiJpb21iOUJ0eSIsImFsZyI6IkhTMjU2In0.eyJkYXRhIjoie1wiaW5zdGFuY2VJZFwiOlwiMWY2ZGM5MDYtODAzZC00NjUwLTgzZjUtNzJlYTFkODgxMDBiXCIsXCJldmVudElkXCI6e1widmFsdWVcIjpcImMyNDFlNmUyLWM5NTEtNDQwZC04YjYyLTUyYTZlYzM4MjE0MFwifSxcIm9jTGlua1wiOm51bGx9IiwiaWF0IjoxNjg5MjUyNzIzfQ.Q-l9WdXV2goH7WL6rlo7gFO7qlX4pliKd3ZjhGYO3U" }, "eventPageUrl": { "base": "https://ievak9.wixsite.com/accessories", "path": "/event-details-registration/natures-symphony-a-musical-journey-through-wildlife" }, "form": { "controls": [ { "type": "NAME", "system": true, "name": "name", "inputs": [ { "name": "firstName", "array": false, "label": "First name", "additionalLabels": {}, "options": [], "mandatory": true, "maxLength": 50, "type": "TEXT", "maxSize": null, "defaultOptionSelection": null, "labels": [] }, { "name": "lastName", "array": false, "label": "Last name", "additionalLabels": {}, "options": [], "mandatory": true, "maxLength": 50, "type": "TEXT", "maxSize": null, "defaultOptionSelection": null, "labels": [] } ], "label": "First name, Last name", "orderIndex": 0, "id": "name" }, { "type": "INPUT", "system": true, "name": "email", "inputs": [ { "name": "email", "array": false, "label": "Email", "additionalLabels": {}, "options": [], "mandatory": true, "maxLength": 255, "type": "TEXT", "maxSize": null, "defaultOptionSelection": null, "labels": [] } ], "label": "Email", "orderIndex": 1, "id": "email" } ], "messages": { "rsvp": { "rsvpYesOption": "I'm Going", "rsvpNoOption": "Not Going", "positiveMessages": { "title": "Add your details", "confirmation": { "title": "Thank you!", "message": "An email with all the event info was sent to you.", "addToCalendarActionLabel": "Add to Calendar", "shareActionLabel": "Share" } }, "waitlistMessages": { "title": "Looks like this event is full. Join the waitlist.", "confirmation": { "title": "Thanks! You've been added to the waitlist.", "message": "We'll update you if additional spots become available.", "addToCalendarActionLabel": "Add to Calendar", "shareActionLabel": "Share" } }, "negativeMessages": { "title": "Add your details", "confirmation": { "title": "Sorry You Can't Make It", "shareActionLabel": "Share" } }, "submitActionLabel": "SUBMIT" }, "checkout": { "title": "Add your details", "submitActionLabel": "Continue" }, "registrationClosed": { "message": "Registration is closed", "exploreEventsActionLabel": "See other events" }, "ticketsUnavailable": { "message": "Tickets are not on sale", "exploreEventsActionLabel": "See other events" } } }, "summaries": { "rsvps": { "totalCount": 0, "yesCount": 0, "noCount": 0, "waitlistCount": 0 }, "tickets": { "ticketsSold": 0, "revenue": null, "currencyLocked": false, "totalOrders": 0, "totalSales": null } }, "instanceId": "1f6dc906-803d-4650-83f5-72ea1d88100b", "guestListSettings": { "displayedPublicly": true }, "userId": "8a8b9b73-4da8-47a5-8268-4396e68a0605", "onlineConferencing": { "session": { "hostLink": "https://www.wixevents.com/oc?start=JWS.eyJraWQiOiJpb21iOUJ0eSIsImFsZyI6IkhTMjU2In0.eyJkYXRhIjoie1wiYWN0aW9uXCI6XCJzdGFydFwiLFwiaW5zdGFuY2VJZFwiOlwiMWY2ZGM5MDYtODAzZC00NjUwLTgzZjUtNzJlYTFkODgxMDBiXCIsXCJldmVudElkXCI6XCJjMjQxZTZlMi1jOTUxLTQ0MGQtOGI2Mi01MmE2ZWMzODIxNDBcIn0iLCJpYXQiOjE2ODkyNTI3MjJ9.KNIfA0xW9EWnUx1BAJk4Qoeqc8C2MIkWEtSxPbQw", "guestLink": "https://www.wixevents.com/oc?join=JWS.eyJraWQiOiJpb21iOUJ0eSIsImFsZyI6IkhTMjU2In0.eyJkYXRhIjoie1wiYWN0aW9uXCI6XCJqb2luXCIsXCJpbnN0YW5jZUlkXCI6XCIxZjZkYzkwNi04MDNkLTQ2NTAtODNmNS03MmVhMWQ4ODEwMGJcIixcImV2ZW50SWRcIjpcImMyNDFlNmUyLWM5NTEtNDQwZC04YjYyLTUyYTZlYzM4MjE0MFwifSIsImlhdCI6MTY4OTI1MjcyMn0.recFci4CCmWizRuPv6hHJV5j5ig5N-NCTi2GAZtYz-E", "password": null, "sessionCreated": null, "sessionId": null } }, "seoSettings": null, "contactLabel": "custom.natures-symphony-a-musical-journey-through-wildlif", "agendaSettings": { "enabled": false, "pageUrl": { "base": "https://ievak9.wixsite.com/accessories", "path": "/schedule/natures-symphony-a-musical-journey-through-wildlife" } }, "categories": [] } }
Errors
400Invalid Argument

There are 2 errors with this status code.

428Failed Precondition

There are 2 errors with this status code.

This method may also return standard errors. Learn more about standard Wix errors.

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