> For the complete documentation index, see [llms.txt](https://voi-nft-bot.gitbook.io/voi-nft-discord-bot-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://voi-nft-bot.gitbook.io/voi-nft-discord-bot-docs/whitelist-contests/create-whitelist-event.md).

# Create Whitelist Event

A whitelist event is a contest where people submit their Voi wallet addresses to be whitelisted for a future event. A CSV including all winners wallet addresses will be available on event completion

## Requires arguments to start a whitelist event

* Channel - The channel to start the whitelist event in
* Name - What is being given away or name for the whitelist event
* Time Frame - Choice between minutes or hours
* Duration - Duration of giveaway using time frame above
* Number Of Winners - How many people will be chosen as a winner
* Force Registration - Yes/No choice and will require a user to register with the bot before joining the event

## Optional arguments to start a whitelist event

* Role To Tag On Start - Tags a role upon whitelist event creation
* Role To Add To Winners - Role to be added to all winners of whitelist event
* Image - Image to be displayed for whitelist event(Upload from library or drag and drop file)

## /whitelist event \[@channel] \[name] \[time-frame] \[duration] \[number-of-winner] \[force-registration]

1. Enter command /whitelist event \[@channel] \[name] \[time-frame] \[duration] \[number-of-winner] \[force-registration]
2. Add optional arguments to command above before submitting