# Required Setup

In this guide, we will be using Birthday Bot's interactive setup command.

Start by using `/setup`.

![](https://birthday-bot-docs-images.s3.amazonaws.com/01-Birthday+channel+option+prompt.png)

You now have three options to choose from to set your birthday channel. The first will automatically generate the default birthday channel; the second will allow you to choose from your server's current channels; and the third will skip setting a birthday channel.

For this example, we will choose the **second** option and receive a prompt.

<figure><img src="https://birthday-bot-docs-images.s3.amazonaws.com/02-Birthday+channel+prompt.png" alt=""><figcaption></figcaption></figure>

Click the "Enter Response" button.

![](https://birthday-bot-docs-images.s3.amazonaws.com/03-birthday+channel+text+modal.png)

You are unable to tag channels in these text modals, so you must enter the name of the channel. Birthday Bot will try and find matching channels;&#x20;

Even if you don't type out the entire channel name, it can still detect the correct channel. For instance, if you have a channel called birthdays-and-anniversaries, if you just enter the word birthdays the bot will still detect the correct channel. Note, if another channel has the term birthday it could incorrectly detect that channel instead.

Once the birthday channel is set, you will receive a second prompt.

![](https://birthday-bot-docs-images.s3.amazonaws.com/04-birthday+role+option+prompt.png)

This prompt is very similar to the previous with the same three options; however, this time, for the birthday **role**.&#x20;

Again, we will choose the second option and receive a similar prompt as before.

![](https://birthday-bot-docs-images.s3.amazonaws.com/05-birthday+role+prompt.png)

Again we will receive a prompt.

![](https://birthday-bot-docs-images.s3.amazonaws.com/06-birthday+role+text+modal.png)

This input box is very similar to the one we saw with the birthday channel. Enter the name (or part of the name) of the role that you would like the birthday role to be.

{% hint style="warning" %}
The Birthday Bot **Role** must be higher than the Birthday Role **and** the Bot must have the **Manage Roles** permissions.&#x20;
{% endhint %}

Finally, you will be given a summary of the completed setup.

<figure><img src="https://birthday-bot-docs-images.s3.amazonaws.com/07-Setup+success+message.png" alt=""><figcaption></figcaption></figure>

This completes the required setup process. View other server setting commands [here](/commands.md#server-configuration-admins-only).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://birthdaybot.scottbucher.dev/server-setup/required-setup.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
