Adding a New User

This guide explains how to add new users to both parent tenant instances and child customer instances in Synthreo’s Tenant Management portal, assign permissions, and ensure they can access the correct applications.

---

🏢 Adding a User (Parent Tenant)

📋 Prerequisites

• Access to Tenant Management portal with appropriate permissions
• User’s email address
• User’s first and last name

🛠️ Steps

1. Go to Tenant Management: https://admin.synthreo.ai/#/login
2. Click User Management in the sidebar.
3. Click the Add User button at the upper-right corner.
4. Enter:
   • User Email (also used as the username)
   • First Name
   • Last Name
5. Click Save to create the account.

Note: Upon creation, the user automatically receives ThreoAI app permission. You can add more permissions as needed.

---

🏢 Adding a User to a Child Customer

📋 Prerequisites

• Access to Tenant Management portal with permissions to manage customer tenants
• User’s email address
• User’s first and last name

🛠️ Steps

1. In Tenant Management, click Customers in the sidebar.
2. Search for the tenant name of the child customer.
3. Click the meatballs menu (three dots) to access the customer detail page.
4. Go to the Users tab.
5. Click Add User and enter:
   • User Email (also used as the username)
   • First Name
   • Last Name
6. Click Save to create the account.

Note: Upon creation, the user automatically receives ThreoAI app permission. You can add more permissions as needed.

---

🔑 User Permissions

Application	Purpose
Tenant Management	Manage users and customer settings
Builder	Create and manage AI agents
ThreoAI	Use AI chat and custom GPTs

---

📬 What Happens Next

• The new user receives a welcome email with setup instructions.
• The setup link is valid for 7 days.
• After completing setup, the user can access assigned applications immediately.

---

📧 Resending a Welcome Email {#resend-email}

🔄 For Parent Tenant Users {#parent-customer-resend}

1. Go to Tenant Management: https://admin.synthreo.ai/#/login
2. Click User Management in the sidebar.
3. Locate the user in the list.
4. Click the envelope icon.

---

🔄 For Child Customer Users / Access Child Customer’s Tenant Management {#child-customer-resend}

1. In Tenant Management, click Customers in the sidebar.
2. Search for the tenant name of the child customer.
3. Click the meatballs menu (three dots) to access the customer detail page.
4. Go to the Accounts tab.
5. Locate the Tenant Management in the list.
6. Click the eye icon beside the user’s name.

You will then see a new window for tenant management for that child customer. Follow the same steps as in ‘For Parent Tenant Users’ to resend the welcome email.

Note: If the user does not have the envelope icon, it means they have already set their password.

---

🛠️ Troubleshooting

If the setup email is not received:

1. Check Spam/Junk folder.
2. Verify the email address entered is correct.
3. Resend the welcome email by following the steps here.
4. Contact Synthreo Support if the issue persists at help@synthreo.ai.

---

:::tip Best Practice Use the user’s email address as both their email and username to maintain consistency. :::

---