/
/
Assign a company role to a Procore project user
For project managers who want a company role assigned to a user on a Procore project with the checks done first, by asking their AI assistant.
On this page
Connector
Connect Procore, pick your AI tool and paste the prompt.
The problem
Role assignments need three lookups and one wrong click
Adding a role to a project user means checking the role, the user and the current holders in separate screens. An inactive user or an unknown role slips through, and someone is assigned twice.
Without PopdockAI
- Check the company roles for the role name
- Find the user on the project and check they are active
- Open the project roles to see who holds it
- Assign it and hope nothing was missed
With PopdockAI
- Unknown roles are refused and the company roles are listed
- Inactive or ambiguous users and existing holders stop the job
- Current holders are shown before you confirm
- One assignment is made and read back with no retry
The prompt
Use this prompt
Copy it into any AI tool connected to PopdockAI. Swap the values in braces for your own.
**Objective:** Assign the company role `{role-name}` on project `{project-name}` to the user `{user-name}`. Use company `{company}` if given.
**Step 1: Confirm the role exists (company-admin server)**
Call `procore-get-roles` filtered by `name` set to `{role-name}`, with `company` set. If no role matches, list the company roles and stop. Keep the role `name`, `type` and `archetype`.
**Step 2: Find the project and the user (core server)**
Call `procore-get-projects` filtered by `project-name`, with `company` set. If it matches more than one project, list them and stop. Keep `project-id`. Then call `procore-get-project-users` filtered by `project-name` and `name.contains` set to `{user-name}`, with `company` set. If it matches more than one user, list them and stop. If the user is not on the project, report that and stop. Keep `user-id`, `name`, `active` and `permission-template`. Refuse if `active` is false.
**Step 3: Check current assignments (core server)**
Call `procore-get-project-roles` filtered by `project-name`. If the user already holds this role on the project, report that and stop. Note who else holds the role.
**Step 4: Confirm**
Show the project, user, permission template, role and type, and anyone else holding the role. Ask the user to confirm. Do not continue without an explicit yes.
**Step 5: Assign and verify**
Call `procore-create-project-role` with `project-id` from Step 2, `project-role-role` set to the role name and `project-role-user-id` set to the user's `user-id`. Then call `procore-get-project-roles` again and confirm the assignment is listed. Report the new assignment id.
**Rules & Guidelines:**
* `procore-get-projects`, `procore-get-project-users`, `procore-get-project-roles` and `procore-create-project-role` are on the core server. `procore-get-roles` is on the company-admin server.
* `procore-create-project-role` is the only write tool allowed, once, and only after confirmation.
* Never call `procore-create-role`, `procore-update-role`, `procore-delete-role`, `procore-delete-project-role`, `procore-update-user-project-roles` or any other create, update or delete tool. Never invent a role the company does not define.
**Validation:**
* Pass the same `company` to every call.
* If the create call fails, report the error and do not retry.Who it's for
One answer, three teams that use it
Project managers
Staff a project role quickly
Give a team member a company role with the current holders visible, instead of checking three screens first.
Assign the Quantity Surveyor role on Contoso Warehouse to Tom Reyes.
Safety and compliance managers
Make sure role holders are active
Inactive users are refused, so a role is never held by someone who has left the project.
Assign Fire Warden on Fabrikam Depot to Dana Whitfield, and check she is active first.
Project administrators
Avoid duplicate role assignments
See who already holds a role and stop if the person does, so assignments stay one per person.
Who holds the Site Engineer role on Northwind Plaza? Assign it to Sofia Alvarez if she does not.
How it works
What PopdockAI does when you ask
You name the role, project and user. Your AI assistant does the checks and shows who else holds the role. It assigns once, after your yes, and never edits or deletes roles.
Ask
You name the role, the project and the user.
Check
It confirms the role exists, finds one project and one active user, and stops if they already hold it.
Confirm
You see the user, template, role and current holders and say yes.
Assign
It assigns the role once and reads the project roles again to confirm it is listed.
What PopdockAI provides
The tools behind the answer
Ready made tools for Procore and one secure connection to your AI tool. No code, no exports.
procore-get-roles
procore-get-projects
procore-get-project-users
procore-get-project-roles
procore-create-project-role
This report is built from Get data tools only. PopdockAI applies the row, field and parameter rules your admin sets, and every query is written to the audit trail.
The outcome
The right role on the right person, confirmed first
Related use cases
More ways to put this data to work
One prompt template with infinite possibilities.
Your AI assistant adapts its approach, tone, and capabilities to match each unique context while you maintain a single, manageable workflow.
Join forward-thinking companies that are transforming their operations with intelligent, secure AI automation.

.webp)
