# Automatic Ranking

{% stepper %}
{% step %}

### Purchase the add-on

The Auto-Ranking system runs on powerful hardware to support a high rate of ranking requests. To help cover the extra costs, we ask **a small one-time fee** to activate this feature for all of your centres.

We support a variety of payment methods, including **PayPal**, **Credit/Debit Card**, **iDEAL**, **Bancontant** and other local providers. \
We also support **Robux** at the DevEx conversion rate after tax (R$ 1K = $2.45) 

<figure><img src="/files/Rmw6UZVhNR42SySmpdoh" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Create an API key

We need to create an API key that will allow us to talk with Roblox.

1. Navigate to [the Creator Hub](https://create.roblox.com/dashboard/credentials?activeTab=ApiKeysTab).
2. Verify that the "**View As**" selector shows your username, and not a group.
3. Click on the **Create API key** button

<figure><img src="/files/NzWDALwO3HXj6UfEZ2Ut" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
**Warning:** You **must** use your personal Roblox account in the **View As** selector. You cannot use group-owned API keys.

We recommend creating the key using the group owner's account or a new bot account. The permissions of the API key creator will be used.
{% endhint %}

### General Information

1. **Name:** This can be anything, like "BloxTech Autoranker"
2. **Description:** Can be left empty

### Access Permissions

1. Enter **groups** and click on **Add API system**.
2. In the field **Select Operations to Add**, add the permission **read** and **write**.

### Security

1. In the **accepted IP addresses** field, enter our dedicated IP address: <kbd>**141.147.17.152/32**</kbd>
2. Press **Add IP Address** to confirm
3. Keep **Expiration** on **No Expiration**

### **Generate the key**

1. Press on **Save & Generate Key**
2. A long key will appear. Click on the **Copy Key to Clipboard** key next to it.
   {% endstep %}

{% step %}

### Connect BloxTech

1. Head back to [the BloxTech dashboard](https://bloxtech.tech/admin/applications/) and open your **Auto-Ranking** settings.
2. Paste your key in the **Enter your API key** field.
3. Navigate to [your Roblox group](https://www.roblox.com/communities/) you want to link to this centre.
4. Copy the URL from the address bar.<br>
5. Paste this link in the **Enter Group ID or URL** field.
6. Press on **Link Bot** to activate automatic ranking for this group.

<figure><img src="/files/BuHhvs0foZpU6gorxJbd" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Mission completed :tada:

If you land on this page, your group has successfully been set up for automatic ranking! You can now configure workflows in the per-role settings. [Read more ➔](/docs/automatic-ranking/role-workflows.md)

<figure><img src="/files/kVRqlRu3sfNJlDy0eeR0" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

## Troubleshooting

<details>

<summary>"Invalid API key or unable to access group"</summary>

<figure><img src="/files/0GNVbXuyYQosZIuyouY4" alt="" width="258"><figcaption></figcaption></figure>

If you see this error, you need to double-check three things:

1. **Did you create the API token on your personal account?** Check the 'View As' switcher on the API keys page on Creator Hub.

<figure><img src="/files/EDnp7OYitIWIRBqibCbV" alt=""><figcaption></figcaption></figure>

1. **Is your API key valid? Did you give it the proper permissions?** Make sure that you have allowed **group:read** *and* **group:write**. Also check if you have configured the proper IP address. It should look like this:

<figure><img src="/files/6d23z9EOpTFvDSpX5iR1" alt=""><figcaption></figcaption></figure>

3. **Is your group link valid?** If you've entered your group ID, try pasting your whole group link. It should look like this:\
   `https://www.roblox.com/communities/11507383/CrimeLogic`

</details>

<details>

<summary>My issue is not in the list</summary>

Feel free to create a [Discord ticket](https://discord.gg/y3YtAddJy7) and we'll get back to you within 12 hours!

</details>


---

# 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://bloxtech.tech/docs/automatic-ranking/automatic-ranking.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.