Connectors

/

Procore

/

Assign a Procore company role to a project user
Write

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.

Try PopdockAI free
Get a live demo
Assign a Procore company role to a project user
Assign the Safety Manager role on the Riverside Tower project to Priya Shah.
Safety Manager is a company role, and Priya Shah is an active user on Riverside Tower who does not hold it yet. - User: Priya Shah, template Project Manager - Role: Safety Manager - Also holding the role: Marcus Lee Shall I assign it?
Procore
Sample figures. Your results come from your own account.
procore-get-roles
procore-get-projects
procore-get-project-users
procore-get-project-roles
procore-create-project-role

On this page

The problem

The problem

The prompt

Who it's for

How it works

Tools used

Connector

Procore

Procore
Run it on your own Procore data.

Connect Procore, pick your AI tool and paste the prompt.

Try PopdockAI free

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.

Prompt
**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.

Your AI tool

Check

It confirms the role exists, finds one project and one active user, and stops if they already hold it.

procore-get-roles
procore-get-projects
procore-get-project-users
procore-get-project-roles

Confirm

You see the user, template, role and current holders and say yes.

No items found.

Assign

It assigns the role once and reads the project roles again to confirm it is listed.

Your AI tool

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.

get-data

procore-get-roles

Returns the company roles defined in Procore, including project role names and their archetypes.
get-data

procore-get-projects

Returns the projects in Procore, with project number, name, stage, active flag and dates. Filter by name, number or status.
get-data

procore-get-project-users

Returns the users on a Procore project with their active status and permission template. Filter by project name and user name.
get-data

procore-get-project-roles

Returns the role assignments on a Procore project: role, assignee name and user id. Filter by project name.
run-action

procore-create-project-role

Assigns a role to a user on a Procore project, given the project id, role name and user id. This writes to live Procore data and has not been run end to end through MCP, so test it in a sandbox before use.
Read only.Nothing in Procore Changes

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.

How Popdock AI secures your data

The outcome

The right role on the right person, confirmed first

Try PopdockAI free
Get a live demo

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.

Try PopdockAI Free
See Documentation