Sync Users and Roles to Breadcrumb
This guide explains how admins in the UK can sync users and role labels from Procore into Breadcrumb. It is intended for situations where you need site hosts and their associated role names in Breadcrumb to reflect the project roles set up in Procore.
What this means
- Breadcrumb can import Procore directories and roles so your project site team appears in Breadcrumb.
- User syncing is driven by Procore project roles, and role names can be imported so you can map Breadcrumb permissions appropriately.
When you’ll use this
- You are going live with Breadcrumb and need site hosts to be created from Procore.
- You have added or updated people or roles in Procore and want those changes reflected in Breadcrumb.
Step-by-step
Common issues
Roles are not appearing in Breadcrumb
What to check
- Confirm the integration setting Import Company Roles is Active.
- Confirm the Procore permission model allows the integration user to read company-level role definitions (roles are managed at the company level in Procore).
What to do
- Have the customer’s Procore admin review the Procore permissions for the integration access.
- After fixing permissions, trigger a resync from the Breadcrumb integration settings if available, then wait for the sync window.
Users appear, but access does not match expectations
What to check
- Remember that only the role label syncs from Procore; what that role can do inside Breadcrumb is configured in Breadcrumb.
What to do
- Review Breadcrumb role permissions and ensure the correct permissions are assigned to the imported roles.
A user’s Procore role changed, but they still have access in Breadcrumb
What to check
- Removing or changing a user’s role in Procore does not necessarily remove their access in Breadcrumb automatically.
What to do
- Manually remove or adjust the user’s access in Breadcrumb as needed (depending on your setup and what you’re trying to achieve).
Why this matters
- Syncing users and roles reduces manual setup work and keeps your site team aligned between systems.
- Getting Procore permissions right prevents missing roles, incomplete user imports, and last-minute go-live issues.
Need help?
If something isn’t syncing as expected, contact your internal Breadcrumb support team and share what you’re seeing (for example: which roles are missing, which project, and when you last attempted the sync).
If you require any assistance or have a question, please contact our Support Team on +44 7400 977 382 or email us at support@breadcrumb.co, and we'll be happy to help.