# Events
# What are events?
Events allow you to assign and manage AWS accounts for a group of users in one place.
This is useful when working with a defined set of participants, for example:
- Running a workshop or hackathon
- Delivering a university subject or training course
- Onboarding a group of new team members
##### Key Characteristics
- **Bulk management** — Create, assign, and manage multiple leases from a single view rather than handling them individually.
- **Pre-creation** — Events can be created and fully provisioned before they start. Accounts and resources are prepared ahead of time so users can start immediately when the event is started.
- **Unassigned leases** — Leases within an event can be created without being assigned to a specific user. This lets you prepare a pool of ready-to-go accounts and assign them to participants later.
- **Limit overrides** — Event-level limits (duration, budget) override the account template defaults. If an account template has a maximum duration of 10 days but the event is configured for 20 days, the event's 20-day limit applies to all leases within it.
##### Event Lifecycle
1. **Created** — The event is defined with its limits, account template, and number of leases. Accounts and resources can be pre-provisioned at this stage. No costs are incurred yet.
2. **Started** — The event is activated. Leases become active and participants can access their assigned accounts.
3. **Ended** — The event concludes. All leases are terminated, access is revoked, and accounts are reclaimed.
##### Events vs Individual Leases
Individual leases are suited for on-demand, self-service access — a single user or small team needing a sandbox. Events are designed for coordinated, group-based scenarios where an organiser needs to prepare and manage many accounts at once with consistent settings.
# Event creation - Overview
To create a new account template:
1. Click on "**Events"** on the left menu
2. Click on "**Create Event**"
[](https://docs.sandboxstudiosoftware.com/uploads/images/gallery/2026-04/uYvimage.png)
Creating an event is a 6-step process listed as follows:
1. [Basic details](https://docs.sandboxstudiosoftware.com/books/manager-guide/page/event-creation-basic-details "Event creation - Basic Details")
2. [Account template](https://docs.sandboxstudiosoftware.com/books/manager-guide/page/event-creation-account-template "Event creation - Account template")
3. [Schedule](https://docs.sandboxstudiosoftware.com/books/manager-guide/page/event-creation-schedule "Event creation - Schedule")
4. [Participants](https://docs.sandboxstudiosoftware.com/books/manager-guide/page/event-creation-participants "Event creation - Participants")
5. [Managers](https://docs.sandboxstudiosoftware.com/books/manager-guide/page/event-creation-managers "Event creation - Managers")
6. [Review](https://docs.sandboxstudiosoftware.com/books/manager-guide/page/event-creation-review "Event creation - Review")
# Event creation - Basic details
First step of the event creation wizard is to set the basic information to describe your event:
[](https://docs.sandboxstudiosoftware.com/uploads/images/gallery/2026-04/yatimage.png)
1. **Name** of the event: Remember, this is will be used by your users to find your event, so make it unique and easy to find!
2. **Description** of the event
3. **Icon**: Choose the icon to identify your event
4. **Colour**: Choose the colour of your event
Having completed all the fields on the Basic Details page as needed, click on **Next** to move to [Event creation - Account template](https://docs.sandboxstudiosoftware.com/books/manager-guide/page/event-creation-account-template "Event creation - Account template")
# Event creation - Account template
In this step, you define the account template you want to use in your event. The account template will define settings like:
1. Permissions
2. Resources created in the event
3. Budget
4. ...
Note: Account templates also define lease duration, but within an event, this is overridden by the event's own duration setting.
[](https://docs.sandboxstudiosoftware.com/uploads/images/gallery/2026-04/Xm7image.png)
Having selected the account template, click on **Next** to move to [Event creation - Schedule](https://docs.sandboxstudiosoftware.com/books/manager-guide/page/event-creation-schedule "Event creation - Schedule")
# Event creation - Managers
This step allows you to define who can manage the event:
- Update event
- Add or remove accounts and assign users
[](https://docs.sandboxstudiosoftware.com/uploads/images/gallery/2026-04/IZvimage.png)
1. Select the **users** who can manage your event
2. Select the **groups of users** who can manage your event
Groups are defined in IAM Identity Center. [How to add groups to IAM Identity Center](https://docs.aws.amazon.com/singlesignon/latest/userguide/addgroups.html)
Once managers are defined, click Next to [Event creation - Review](https://docs.sandboxstudiosoftware.com/books/manager-guide/page/event-creation-review "Event creation - Review")
# Event creation - Schedule
This steps define the schedule of an event.
[](https://docs.sandboxstudiosoftware.com/uploads/images/gallery/2026-04/b6kimage.png)
Schedule are defined as follows:
##### Start Date
- **Start now**
Selecting this option will automatically provision the accounts *(aka, create leases)* and start the event.
- - **Pros**: Easy, the event starts immediately and you can start right away!
- **Cons**: If your account template provisions resources in the account, you will need to wait for the accounts to be ready before accessing them. This provisioning time counts towards your event duration
- **Start on a specific date**
You can set the event to start on a specific date (and time) you define. This is particularly useful is you want to schedule an event to start automatically in the future.
[](https://docs.sandboxstudiosoftware.com/uploads/images/gallery/2026-04/sy9image.png)
- - **Pros**: "Set and forget", the event will automatically start at the date/time of your choice. This option also allows you to pre-provision the accounts before the event starts, so you don't have to wait for the resources to be created in the accounts.
- **Cons**: Not much! But as per the "Start now" option, If your account template provisions resources in the account, you will need to either pre-provision the account manually before the start of the event or wait for the accounts to be ready before accessing them.
- **Start later**
You can chose not to start the event automatically. In this instance, you will have to start the event manually.
- **Pros**: No rush! You can take your time to create and configure the event. You can also update this value later if you finally decide to start the event automatically.
- **Cons**: The event won't starts automatically, so you will need to start it manually.
##### End Date
Note: Account templates also define lease duration, but within an event, this is overridden by the event's own duration setting.
- **End on a specific date**
Automatically ends the event on a specific date/time. When this date/time comes, the event will be terminated and leases will be terminated.
- **End after a specific amount of time**
Automatically ends the event after a specific amount of time: The count down starts when the event is started. Use this option if you want to terminate the event after some time. For instance: *"Terminate the event after 7 days"*
- **No end date**
With this option, the event will not be terminated automatically. So you will have to terminate the event manually.
Having set the schedule, click on **Next** to move to [Event creation - Participants](https://docs.sandboxstudiosoftware.com/books/manager-guide/page/event-creation-participants "Event creation - Participants")
# Event creation - Participants
This step allows you to define how many accounts (leases) you want to have as part of your event.
For instance, for a hackathon with 5 participants, you would define 5 accounts:
[](https://docs.sandboxstudiosoftware.com/uploads/images/gallery/2026-04/O3Himage.png)
1. **Set the number of accounts** you want to create
Note: You can reserve accounts for your event by adding an account and not assigning it to any user
2. For big events, you can **import a CSV** file with the list of events
3. **Assign users** to the event you will create
##### How to assign user to an account
Click on the "Assign user" button and select the user you want to assign to an account. Once assigned, the status becomes "**Assigned**"
[](https://docs.sandboxstudiosoftware.com/uploads/images/gallery/2026-04/qy7image.png)
If you let the account "Unassigned", a lease will be created but not assigned to any user. This is a way to "reserve" an account and prepare it before later assigning it to users.
##### How to import a CSV
Click on the Import button:
[](https://docs.sandboxstudiosoftware.com/uploads/images/gallery/2026-04/UPUimage.png)
You can then Drag and Drop your CSV file:
[](https://docs.sandboxstudiosoftware.com/uploads/images/gallery/2026-04/tN9image.png)
Format of the CSV file is as follows:
```
email1@example.com
email2@example.com
email3@example.com
```
Only valid e-mail addresses will be processed. So if you add a header to CSV file, it will be ignored.
Sandbox Studio will then check the CSV file:
[](https://docs.sandboxstudiosoftware.com/uploads/images/gallery/2026-04/Cbdimage.png)
After a few seconds (depending on how many users are in the CSV file):
[](https://docs.sandboxstudiosoftware.com/uploads/images/gallery/2026-04/Vtdimage.png)
Only the found users will be added to the event:
[](https://docs.sandboxstudiosoftware.com/uploads/images/gallery/2026-04/ob4image.png)
Once account numbers are set and users assign, click Next to [Event creation - Managers](https://docs.sandboxstudiosoftware.com/books/manager-guide/page/event-creation-managers "Event creation - Managers")
# Event creation - Review
Last step of the event creation wizard, the review screen allows to check everything is correct:
[](https://docs.sandboxstudiosoftware.com/uploads/images/gallery/2026-04/Ci5image.png)
Click Submit to create your event.
You are automatically redirected to your event page:
[](https://docs.sandboxstudiosoftware.com/uploads/images/gallery/2026-04/s4Simage.png)
# Terminate events
Depending on your event configuration, your event can be stopped :
- At a specific date
- After a certain duration (from the event start date)
- Manually, by an event manager
##### Event lifecycle
High level lifecycle of an event is as follows:
##### Stoping an event manually
Open the event and click on the "Terminate event":
[](https://docs.sandboxstudiosoftware.com/uploads/images/gallery/2026-04/r2Yimage.png)
All leases will be terminated, users will be notified, and accounts are going to cleanup before returning to accounts pool.
[](https://docs.sandboxstudiosoftware.com/uploads/images/gallery/2026-04/GF9image.png)
# Start events and provision accounts
Depending on your event configuration, your event can:
- Start immediately
- The event (and provisioning of the accounts) start when the event is created
- Start on a specific date
- The event (and provisioning of the accounts) start on a schedule
- Account can be provisioned manually before the event
- Be started manually at a later date
- The event has to be started manually.
- Account can be provisioned manually before the event or will be automatically provisioned when the event is started.
##### Event lifecycle
High level lifecycle of an event is as follows:
The "Provisioning" step (aka "Preparing account") is what can take the longest as this is during this steps the accounts are configured and resources (if any) are created.
For account template creating resources in the accounts, we recommend pre-provisioning the account before the event starts as otherwise, the provisioning step will count towards the event duration.
##### A concrete example:
Let's assume you event must run for 2 days and you have 50 participants. Each account preparation takes 1 hour.
By default, AWS Codebuild (used to create resources in the accounts) is limited to 15 concurrent executions. So you could only parallelise 15 accounts provisioning.
In total:
```
15 accounts x 1h + 15 accounts x 1h + 15 accounts x 1h + 5 accounts x 1h = 4h to provision all accounts.
```
So your users will have to wait for all the accounts to be created before accessing the event!
##### Starting an event
Open the event and click on the "Start event":
[](https://docs.sandboxstudiosoftware.com/uploads/images/gallery/2026-04/cNUimage.png)
If the accounts have not been provisioned manually, they will be automatically be when the event starts.
##### Pre-provision accounts
If you want to prepare the accounts before the event starts, click on the small arrow in the "Start event" button and select "Prepare accounts only":
[](https://docs.sandboxstudiosoftware.com/uploads/images/gallery/2026-04/KlYimage.png)
This will trigger the accounts preparation:
[](https://docs.sandboxstudiosoftware.com/uploads/images/gallery/2026-04/1ceimage.png)
You can follow progress by going to the "Accounts" tab:
[](https://docs.sandboxstudiosoftware.com/uploads/images/gallery/2026-04/m8Kimage.png)
After a few minutes (depending on your launch template), the event is ready to start:
[](https://docs.sandboxstudiosoftware.com/uploads/images/gallery/2026-04/Juvimage.png)
You can now start the event! 