> Portal Navigation: > > - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version. > - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages). > - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`). > - Top-level index of all portals: https://dev.wix.com/docs/llms.txt > - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt ## Resource: Sample Flow ## Article: Sample Flow ## Article Link: https://dev.wix.com/docs/api-reference/business-solutions/events/event-management/sample-flow.md ## Article Content: # Event Management: Sample Use Cases & Flows This article presents possible use cases and corresponding sample flows that you can support. It provides a useful starting point as you plan your implementation. ## Set up a paid conference with multiple ticket definitions This use case demonstrates how to create a professional multi-day conference with various ticket definitions, detailed agenda, and event policies. This represents a complete ticketed event setup from start to finish. You're organizing a 2-day tech conference called "DevCon 2025" at a convention center. You need to sell different ticket types (Early Bird, General Admission, VIP), collect attendee information including dietary preferences, display a detailed schedule of sessions, and set cancellation policies. To set up this conference, follow these steps: ### Step 1 | Create the event 1. Call [Create Event](https://dev.wix.com/docs/api-reference/business-solutions/events/event-management/events-v3/create-event.md) to create the basic event structure: ```json { "event": { "title": "DevCon 2025 - Developer Conference", "description": "Join us for two days of cutting-edge talks, workshops, and networking with industry leaders.", "location": { "type": "ADDRESS", "address": { "formatted": "Metro Convention Center, 1234 Tech Plaza, San Francisco, CA 94103", "city": "San Francisco", "subdivision": "CA", "country": "US" } }, "scheduling": { "config": { "startDate": "2025-06-15T09:00:00.000Z", "endDate": "2025-06-16T18:00:00.000Z", "timeZoneId": "America/Los_Angeles" } }, "registration": { "initialType": "TICKETING", "status": "OPEN_TICKETS" }, "status": "SCHEDULED" } } ``` 2. Save the returned `eventId` for later use. ### Step 2 | Set up ticket definitions 1. Call [Create Ticket Definition](https://dev.wix.com/docs/api-reference/business-solutions/events/event-management/ticket-definitions-v3/introduction.md) 3 times to create different ticket definitions: **Early Bird ticket:** ```json { "ticketDefinition": { "eventId": "{eventId}", "name": "Early Bird", "description": "Limited time offer - save 40%!", "pricing": { "pricingOptions": { "options": [ { "name": "Early Bird Price", "price": { "value": "299.00", "currency": "USD" } } ] } }, "limitPerCheckout": 5, "orderIndex": 0, "salePeriod": { "startDate": "2025-03-01T00:00:00.000Z", "endDate": "2025-04-30T23:59:59.000Z" }, "policy": { "limit": 100 } } } ``` **General Admission ticket:** ```json { "ticketDefinition": { "eventId": "{eventId}", "name": "General Admission", "pricing": { "fixedPrice": { "price": { "value": "499.00", "currency": "USD" } } }, "limitPerCheckout": 5, "orderIndex": 1, "salePeriod": { "startDate": "2025-03-01T00:00:00.000Z", "endDate": "2025-06-14T23:59:59.000Z" }, "policy": { "limit": 500 } } } ``` **VIP ticket with price options:** ```json { "ticketDefinition": { "eventId": "{eventId}", "name": "VIP All-Access Pass", "description": "Includes exclusive workshops, VIP lounge access, and speaker meet & greet", "pricing": { "pricingOptions": { "options": [ { "name": "Individual", "price": { "value": "999.00", "currency": "USD" } }, { "name": "Team (3+ people)", "price": { "value": "899.00", "currency": "USD" } } ] } }, "limitPerCheckout": 10, "orderIndex": 2, "salePeriod": { "startDate": "2025-03-01T00:00:00.000Z", "endDate": "2025-06-14T23:59:59.000Z" }, "policy": { "limit": 50 } } } ``` ### Part 4: Create the event schedule 1. Call [Add Schedule Item](https://dev.wix.com/docs/api-reference/business-solutions/events/event-management/schedule-items/add-schedule-item.md) multiple times to build the conference agenda: **Day 1 - Opening keynote:** ```json { "scheduleItem": { "eventId": "{eventId}", "item": { "name": "Opening Keynote: The Future of AI", "description": "Join our CEO as she explores emerging trends in artificial intelligence", "timeSlot": { "start": "2025-06-15T09:00:00.000Z", "end": "2025-06-15T10:00:00.000Z" }, "stageName": "Main Stage", "tags": ["Keynote", "AI", "Machine Learning"] } } } ``` **Day 1 - Breakout sessions:** ```json { "scheduleItem": { "eventId": "{eventId}", "item": { "name": "Workshop: Building Scalable Microservices", "description": "Hands-on workshop covering architecture patterns and best practices", "timeSlot": { "start": "2025-06-15T11:00:00.000Z", "end": "2025-06-15T12:30:00.000Z" }, "stageName": "Workshop Room A", "tags": ["Workshop", "Architecture", "Backend"] } } } ``` Continue adding schedule items for lunch breaks, afternoon sessions, networking events, etc. 2. Call [Publish Draft](https://dev.wix.com/docs/api-reference/business-solutions/events/event-management/schedule-items/publish-draft.md) to make the schedule visible to attendees. ### Step 5 | Set up event policies 1. Call [Create Policy](https://dev.wix.com/docs/api-reference/business-solutions/events/event-management/policies-v2/create-policy.md) to add a cancellation policy: ```json { "policy": { "eventId": "{eventId}", "name": "Cancellation & Refund Policy", "body": "Full refund available up to 30 days before the event. Partial refund (50%) available 15-29 days before the event. No refunds within 14 days of the event. All refunds subject to processing fees." } } ``` 2. Create additional policies for code of conduct and ticket transfer: ```json { "policy": { "eventId": "{eventId}", "name": "Code of Conduct", "body": "All attendees must adhere to our code of conduct. Harassment of any kind will not be tolerated. We are committed to providing a safe and inclusive environment for all participants." } } ``` ```json { "policy": { "eventId": "{eventId}", "name": "Ticket Transfer Policy", "body": "Tickets may be transferred to another person up to 7 days before the event by contacting our support team. A $25 processing fee applies to all transfers." } } ``` ### Step 6 | Organize with categories 1. Call [Create Category](https://dev.wix.com/docs/api-reference/business-solutions/events/event-management/categories/create-category.md) to create relevant categories: ```json { "category": { "name": "Technology Conferences", "states": ["MANUAL"] } } ``` 2. Call [Assign Events](https://dev.wix.com/docs/api-reference/business-solutions/events/event-management/categories/assign-events.md) to assign your event to a category.