> ## Documentation Index
> Fetch the complete documentation index at: https://docs.convocore.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Creating Users

> Add client users, assign access, and invite them into the whitelabel dashboard.

Adding users to a client organization is how you give real people access to the client-facing dashboard. Each user can have a different permission set depending on what they need to manage.

## Open user management

<Steps>
  <Step title="Go to Clients">
    Open the `Clients` section in your whitelabel dashboard.
  </Step>

  <Step title="Select an organization">
    Choose the client organization you want to manage.
  </Step>

  <Step title="Open Manage">
    Click `Manage` to access the organization's users and settings.
  </Step>
</Steps>

<Note>
  New organizations start with an empty user list. After adding users, you can organize them into [teams](/whitelabeling/clients/managing-teams) if your workflow requires handoff or collaboration.
</Note>

<Tip>
  If you need the full hierarchy explained in one place, including workspace-side admins, org admins, client users, logs, and KB history, see [Access, Roles, and Activity Logs](/whitelabeling/clients/access-and-roles).
</Tip>

<Frame>
  <img src="https://mintcdn.com/convocore/kNoD7_2-fZetOeo6/images/orgnization-table-ui.png?fit=max&auto=format&n=kNoD7_2-fZetOeo6&q=85&s=4b6ffc83330a1a4f6e7aa5d8fc127417" width="2273" height="477" data-path="images/orgnization-table-ui.png" />
</Frame>

## Add a user

<Steps>
  <Step title="Click Add User">
    Use the `Add User` button in the top-right corner of the user management view.
  </Step>

  <Step title="Enter profile details">
    Add the user's full name, email address, password, and optional profile image.

    <Warning>
      Double-check the email address before saving. This is the account the client will use for login and invitations.
    </Warning>
  </Step>

  <Step title="Choose permissions">
    Decide what this user should be able to see and manage inside the client dashboard.
  </Step>

  <Step title="Save the user">
    Click `Add User` to create the account.

    <Frame>
      <img src="https://mintcdn.com/convocore/45Ecjxi6tZs54Ia5/images/add-user-ui.png?fit=max&auto=format&n=45Ecjxi6tZs54Ia5&q=85&s=4f118923aaf217698d408018ee4dbfab" style={{ width: '500px', borderRadius: '1.2rem' }} width="1016" height="935" data-path="images/add-user-ui.png" />
    </Frame>
  </Step>
</Steps>

## Permission overview

These permissions control what the user can do inside the client dashboard:

* `Org Admin`: Can edit organization details and manage other users in the same organization
* `Home`: Access the overview and dashboard landing experience
* `Conversations`: View conversation history and manage transcripts
* `Analytics`: Access performance reporting and usage-related views
* `Knowledge Base`: View and update KB documents
* `Channels`: Manage channel connections and channel-level settings
* `Prompt`: Edit prompts, model choices, tools, UI behavior, and related agent settings
* `Settings`: Access the agent settings exposed to the client dashboard
* `Custom Tab`: Access agency-created tabs configured through [Custom Tabs](/whitelabeling/agency/custom-tabs)

<Note>
  `Org Admin` is a client-organization role. It is separate from workspace owner or workspace admin access in the main Convocore app.
</Note>

<Tip>
  The available areas depend on how your agency has configured the dashboard and plan limits. For a user-friendly overview of the client experience, see [Client Dashboard Features](/whitelabeling/clients/client-dashboard/features).
</Tip>

## Invite the user

After the user is created, send them access to the dashboard:

<Steps>
  <Step title="Review the setup">
    Use the `Log in` option first if you want to preview the dashboard from the client's perspective.
  </Step>

  <Step title="Find the user">
    Locate the user in the organization's user table.
  </Step>

  <Step title="Send invite">
    Click `Invite` to send the login email.
  </Step>

  <Step title="Confirm">
    Verify the details and send the invitation.
  </Step>
</Steps>

<Note>
  The invitation email includes a login link for the client dashboard. Make sure the email address is correct before sending it.
</Note>

## Manage existing users

<AccordionGroup>
  <Accordion title="Edit a user">
    Open the user row, click `Edit`, update the profile or permissions, and save your changes.
  </Accordion>

  <Accordion title="Delete a user">
    Removing a user deletes their access to the client dashboard. Review carefully before confirming deletion.
  </Accordion>

  <Accordion title="Reset a user's password">
    Users can reset their own password from the client login screen using `Forgot password`. The reset email is branded using the whitelabel email setup for that client environment.
  </Accordion>
</AccordionGroup>

## Best practices

<CardGroup cols={2}>
  <Card title="Start with one org admin" icon="user-shield">
    Give the first trusted contact administrative access so they can help manage their own team.
  </Card>

  <Card title="Use least privilege" icon="shield-check">
    Only grant the sections the user actually needs to keep the dashboard simple and secure.
  </Card>

  <Card title="Audit access regularly" icon="clipboard-check">
    Review users and permissions periodically, especially after team changes.
  </Card>

  <Card title="Set expectations clearly" icon="comments">
    Tell clients which pages they can access and who to contact if they need broader permissions.
  </Card>
</CardGroup>

## Related documentation

<CardGroup cols={2}>
  <Card title="Access & Roles" icon="shield-check" href="/whitelabeling/clients/access-and-roles">
    Review the full role model, including workspace-side roles and activity logs.
  </Card>

  <Card title="Managing Organizations" icon="building" href="/whitelabeling/clients/managing-organizations">
    Learn how organizations, assigned agents, and org settings fit together.
  </Card>

  <Card title="Managing Teams" icon="people-group" href="/whitelabeling/clients/managing-teams">
    Organize client users for support, handoff, and collaboration.
  </Card>

  <Card title="Client Dashboard Features" icon="gauge" href="/whitelabeling/clients/client-dashboard/features">
    Understand the client-facing areas users can access.
  </Card>

  <Card title="Billing Overview" icon="credit-card" href="/whitelabeling/clients/client-billing/billing-overview">
    Learn how billing interacts with organizations, plans, and subscriptions.
  </Card>
</CardGroup>
