# Create a Subuser

**Step 1: Open the Sub-user Management**

{% hint style="info" %}
You can create only three SubUsers.
{% endhint %}

* Log in to the Zata.ai dashboard.
* From the left sidebar, go to **Subusers → Subusers**
* You will see the **Sub-user Management** page

<figure><img src="https://2683631041-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPPVG4W649TwXN8OejRhb%2Fuploads%2FZAfQj3rPBFTG56Rkaez3%2Fimage.png?alt=media&#x26;token=59175a44-612e-4f8f-a0f2-35ddbafe27c3" alt=""><figcaption></figcaption></figure>

**Step 2: Create a New Subuser**

* Click on **Create Subuser** (top right button)

  A popup will open: **Create Subuser**

**Required Fields**

* Username:
  * Must be unique
  * Allowed characters:
    * Letters (a–z, A–Z)
    * Numbers (0–9)
    * Dot (.)
    * Underscore (\_)
    * Dash (-)
  * Length: **1–64 characters**
* Email:
  * Enter a valid email address
* Region:
  * Select the required region from dropdown(indore)

**Optional Field**

* Description
  * Add any note (optional)

<figure><img src="https://2683631041-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPPVG4W649TwXN8OejRhb%2Fuploads%2FiyuQBAzPUxDp5QcC0wTg%2Fimage.png?alt=media&#x26;token=12e9b4a5-ed63-4599-914c-3414c5d73dd8" alt=""><figcaption></figcaption></figure>

**Step 3: Create the Sub-user**

* Click on **Create Subuser**

After clicking:

* Sub-user is created successfully
* A **credentials file is automatically downloaded**

Important Note:

* This file contains:
  * Access Key
  * Secret Key
* You **cannot retrieve the Secret Key again later.**

**Step 4: Save Credentials Securely**

* Downloaded file must be stored securely
* If lost:

  * You need to **generate a new key**
  * Old key must be deleted.

**Step 5: Verify Sub-user Creation**

After creation, you will see the sub-user listed with:

* Username
* Assigned Buckets
* Status (**Active**)
* Last Active
* Actions

Status should be **Active** but Initially, no bucket is assigned

<figure><img src="https://2683631041-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPPVG4W649TwXN8OejRhb%2Fuploads%2FMcfbaE2p2aiZpnTanvhn%2Fimage.png?alt=media&#x26;token=f5d15fac-2f59-4e04-9d1e-55b00f21f9ae" alt=""><figcaption></figcaption></figure>

**Step 6: Open Sub-user Details**

* Click on the **Sub-user name**

&#x20;You will open **Bucket Access Management page**

**Step 7: Assign Bucket**

* Click on **+ Assign New Bucket**

You will proceed to assign access to a bucket

<figure><img src="https://2683631041-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPPVG4W649TwXN8OejRhb%2Fuploads%2FzsSCiEPkyh27dueTIN0O%2Fimage.png?alt=media&#x26;token=d4605d2c-cf2b-447f-96e5-03941ab0b634" alt=""><figcaption></figcaption></figure>

**Step 8: Configure Access Rule**

A popup will appear: **Add Access Rule**

Select permission:

| Permission    | Description      |
| ------------- | ---------------- |
| View Only     | Read access      |
| Upload Only   | Upload only      |
| View & Upload | Read + Write     |
| Full Access   | Complete control |

For testing, select **Full Access**

* Click **Create Rule**

<figure><img src="https://2683631041-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPPVG4W649TwXN8OejRhb%2Fuploads%2FHKWJv8Kx2iEwVNyoAuKX%2Fimage.png?alt=media&#x26;token=377a81e3-b468-47c9-a066-468f64534324" alt=""><figcaption></figcaption></figure>

**Step 9: Verify Access Rule**

You will be redirected to **Manage Bucket Access Rules page**

Check:

* Permission → Full Access
* Status → Active

&#x20;This confirms access is successfully configured

<figure><img src="https://2683631041-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPPVG4W649TwXN8OejRhb%2Fuploads%2Fy7r8mfLSO4UixuQJJsM0%2Fimage.png?alt=media&#x26;token=4bdce7fb-8073-466a-958f-44fbf8e842c6" alt=""><figcaption></figcaption></figure>

**Step 10: Final Verification**

Go back to **Sub-user Management page.**

Check:

* Assigned Buckets : 1
* Status :  Active

Sub-user is now ready to use

<figure><img src="https://2683631041-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPPVG4W649TwXN8OejRhb%2Fuploads%2FCuHNFQOjqgkzt1VDL7HE%2Fimage.png?alt=media&#x26;token=74dc8857-afa1-43c6-bd1b-cc5eb9f32963" alt=""><figcaption></figcaption></figure>

Sub-user creation and access configuration is successfully completed.\
The user can now access assigned buckets using S3-compatible tools.

<figure><img src="https://2683631041-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPPVG4W649TwXN8OejRhb%2Fuploads%2FRAErJXx0BbcDWXmF0qi2%2Fimage.png?alt=media&#x26;token=369ea9fe-4a68-4196-a24b-fc1a7f32c987" alt=""><figcaption></figcaption></figure>
