> ## 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.

# Drive contact portal access and roles from your CRM

> Map portal access and contact roles to CRM properties so the CRM controls who logs in and how contacts are grouped.

Deciding who gets portal access is easier when a CRM field your sales team already maintains drives it. Mapping contact portal access to a CRM property lets the CRM grant or revoke logins automatically, so access stays consistent with the records sales owns and nobody manages a second list by hand. In the same place you can map a contact role property, which groups partner contacts for segments and reports. This guide sets both up end to end so access and roles stay in sync with the CRM in both directions.

## What you'll achieve

A two-way mapping where setting the access property to a positive value in the CRM grants a contact active portal access (and a negative value revokes it), and where each contact's role comes from a CRM field, so segments and reports group contacts correctly without manual upkeep.

## Before you start

<Steps>
  <Step title="Connect your CRM">
    A CRM must be connected and syncing partner contacts.
  </Step>

  <Step title="Create the CRM properties">
    On the contact in your CRM, create an **access** property that is either a checkbox or a Yes/No dropdown (the values "Yes/true" grant access and "No/false" revoke it), and, if you want roles, a **role** property as a dropdown or text field. The properties must be writable, not read-only.
  </Step>
</Steps>

## Steps

<Steps>
  <Step title="Open a partner's People">
    Go to [Partners](https://app.introw.io/partners), open a partner, and go to the **People** tab where its contacts are listed.
  </Step>

  <Step title="Open the field sync">
    Select **Configure** to open the people properties, then on the **Portal access** or **Contact role** row select **Sync** (the CRM logo button). This opens **Sync contact fields with \[your CRM]**, where you map portal access and the CRM property used for contact roles. The button reads **In Sync** once a mapping exists.
  </Step>

  <Step title="Map the access property">
    Set **Access property** to the CRM contact property that controls portal access. Only eligible properties appear: a checkbox property, or a dropdown whose options are exactly Yes and No. This is the field the CRM uses to decide who logs in: a positive value keeps the contact's access active, and a negative value revokes it.
  </Step>

  <Step title="Map the role property">
    Set **Role property** to the CRM contact field used for partner contact roles in segments and reports. Eligible fields are a dropdown or a plain text field with no relationship to another object. This groups contacts (for example by their job or function) so your segments and reports can target them. Leave it unset if you only want to drive access.
  </Step>

  <Step title="Save">
    Select **Save**. Introw confirms the contact field mappings have been updated.
  </Step>
</Steps>

## Verify it worked

Set the access property to its positive value on a contact in the CRM: after the next sync that contact has active portal access in Introw. Set it to the negative value and the contact's access is revoked. If you mapped a role, each contact shows its CRM role value, and your segments and reports group contacts by it.

## Related

<CardGroup cols={2}>
  <Card title="Sync partner tiers and roles to your CRM" icon="book-open" href="./map-tiers-to-a-crm-property">
    Push tiers, programs, and team roles back to the CRM.
  </Card>

  <Card title="Manage portal access" icon="book-open" href="/features/portal/portal-access/technical">
    Learn about all the ways access is granted.
  </Card>

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