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

# Create an internal role

> Build a reusable role from permission categories, choose an access type, optionally scope it to a user's assigned partners, then set notifications and assign users.

Roles let you grant access by job rather than per person, so the next hire inherits the right permissions instantly. This guide builds a role end to end: you name it, pick how broad its access is, choose exactly which areas of the program it reaches, decide which email notifications its users get, and assign the people who hold it. It also covers the Partner manager access type, which is how you keep a user focused on only the partners assigned to them.

## What you'll achieve

A reusable role that grants a specific set of permissions, optionally limited so its users only ever see their assigned partners, with notifications configured and the right people assigned to it.

## Before you start

<Steps>
  <Step title="Have Team access">
    You need Team access to create and edit roles. Roles live on the **Roles** tab of Team settings.
  </Step>

  <Step title="List the areas this role needs">
    Decide which parts of the program the role should reach (for example Partners, Commissions, or Integrations) and whether its users should be limited to their own assigned partners.
  </Step>

  <Step title="Plan partner assignments (if scoping)">
    If you will use the Partner manager access type, make sure partners are, or will be, assigned to the right people so scoped users actually see their book.
  </Step>
</Steps>

## Watch it

<Tabs>
  <Tab title="Video">
    <video controls playsInline preload="none" poster="https://assets.introw.io/docs/features/access/team-management/guides/create-an-internal-role/steps/01.png?v=1783346769" className="w-full rounded-xl" src="https://assets.introw.io/docs/features/access/team-management/guides/create-an-internal-role/video.webm?v=1783346769#t=2.5" />
  </Tab>

  <Tab title="Click through">
    <iframe className="w-full rounded-xl" style={{ width: "100%", aspectRatio: "16 / 11", border: 0, backgroundColor: "#FAFAFA" }} src="https://assets.introw.io/docs/features/access/team-management/guides/create-an-internal-role/walkthrough.html?v=1783346769" />
  </Tab>
</Tabs>

## Steps

### Create the role

<Steps>
  <Step title="Open Roles">
    Go to [Team](https://app.introw.io/settings/team) and open the **Roles** tab.

    <Frame>
      <img src="https://assets.introw.io/docs/features/access/team-management/guides/create-an-internal-role/steps/01.png?v=1783346769" alt="Open Roles" />
    </Frame>
  </Step>

  <Step title="Create a new user role">
    Select **Create role**, then give the role a **Name** and pick a starting point under **Start from a template**. The template only seeds the initial permissions; you can change everything afterwards.

    * **Admin** - starts with every permission on all partners.
    * **Partner manager** - starts limited to the user's assigned partners, with no module permissions.
    * **Sales rep** - access tailored for sales reps based on your CRM setup (shown as a CRM-based option when HubSpot is connected).
    * **Create from scratch** - starts with all categories on and no scoping, ready for you to trim.

    Select **Create role** to open the role editor, which steps through Details, Permissions, Notifications, and Users.

    <Frame>
      <img src="https://assets.introw.io/docs/features/access/team-management/guides/create-an-internal-role/steps/04.png?v=1783346769" alt="Create a new user role" />
    </Frame>
  </Step>

  <Step title="Set the details">
    On the **Details** step, confirm the **Role name** and add a **Description** so colleagues understand what the role is for. Select **Continue**.

    <Frame>
      <img src="https://assets.introw.io/docs/features/access/team-management/guides/create-an-internal-role/steps/08.png?v=1783346769" alt="Set the details" />
    </Frame>
  </Step>
</Steps>

### Choose access and permissions

<Steps>
  <Step title="Pick an access type">
    On the **Permissions** step, choose an **Access type**. This decides the shape of the role before you fine-tune individual areas.

    * **Admin** - grants all permissions on all partners. Use for full administrators.
    * **Custom** - lets you turn individual permission categories on and off. Use for most roles.
    * **Partner manager** - limits the user to managing only their assigned partners. This is the scoping option: users in the role see only the partners assigned to them across the program, which keeps their view focused and protects other managers' relationships. Choose this for reps who should work only their own book.
    * **CRM only user** - limits the user to managing their partners through the CRM with no Introw configuration access (available when HubSpot is connected). These users do not count against your paid seat allowance.

    <Frame>
      <img src="https://assets.introw.io/docs/features/access/team-management/guides/create-an-internal-role/steps/10.png?v=1783346769" alt="Pick an access type" />
    </Frame>
  </Step>

  <Step title="Set the permissions">
    Below the access type, the permissions are grouped into collapsible cards - **General**, **Portal**, **Commissions**, **Track**, **Engage**, and **Settings** - each holding the individual categories (for example Partners, Journeys, Assets, Goals, Courses, Plans, Reports, Announcements, Team, Integrations, Single sign-on). Turn on only the categories this role should reach; toggle a whole card to enable or disable its group at once.

    A few notes that affect what you see and can change:

    * With **Partner manager** selected, the user stays limited to their assigned partners even as you grant categories.
    * With **CRM only user** selected, the other permission options are disabled because those users never enter Introw directly.
    * Some categories only appear when the related add-on is on your plan (for example Single sign-on, the Commissions categories, and Deal Coaching).
    * You cannot remove the **Team** permission from the role you are currently assigned to.

    Select **Continue**.

    <Frame>
      <img src="https://assets.introw.io/docs/features/access/team-management/guides/create-an-internal-role/steps/12.png?v=1783346769" alt="Set the permissions" />
    </Frame>
  </Step>
</Steps>

### Set notifications and assign users

<Steps>
  <Step title="Choose notifications">
    On the **Notifications** step, choose which email notifications users with this role receive. Changes apply to everyone assigned to the role, so set them to match the role's job rather than one person's preference. Select **Continue**.

    <Frame>
      <img src="https://assets.introw.io/docs/features/access/team-management/guides/create-an-internal-role/steps/15.png?v=1783346769" alt="Choose notifications" />
    </Frame>
  </Step>

  <Step title="Assign users and save">
    On the **Users** step, assign the people who should hold this role. Then select **Save role** to apply it. Edits to a role apply to all users who have it.

    <Frame>
      <img src="https://assets.introw.io/docs/features/access/team-management/guides/create-an-internal-role/steps/17.png?v=1783346769" alt="Assign users and save" />
    </Frame>
  </Step>
</Steps>

## Verify it worked

The role appears on the **Roles** tab and can be selected when inviting or editing a user. If you chose the Partner manager access type, users in the role see only the partners assigned to them across the program; if you assigned partners after saving, those users see exactly that book.

## Related

<CardGroup cols={2}>
  <Card title="Invite a team member" icon="book-open" href="./invite-a-team-member">
    Assign the new role to a person.
  </Card>

  <Card title="Set up partner team roles" icon="book-open" href="./set-up-partner-team-roles">
    Assign partners to the people who manage them.
  </Card>

  <Card title="Implementation reference" icon="screwdriver-wrench" href="../technical">
    Full configuration options.
  </Card>
</CardGroup>
