/
/
Create Procore punch items with the right category and note
For superintendents and QA leads who want a punch item and its first comment added by asking their AI assistant.
On this page
Connector
Connect Procore, pick your AI tool and paste the prompt.
The problem
Punch items go in with the wrong category
A punch item needs a category from the project's list and a title that is not already open. Pick wrongly or repeat a title and the item reaches the wrong trade, with its explanation typed in a separate step.
Without PopdockAI
- Find the project and open its punch list
- Scan open items for the same title
- Pick the category from the dropdown
- Add the first comment as a second step
With PopdockAI
- The category is matched to the project's own types
- An open item with the same title is flagged
- You confirm the exact values first
- The comment is added once and the item is read back
The prompt
Use this prompt
Copy it into any AI tool connected to PopdockAI. Swap the values in braces for your own.
**Objective:** Create a punch item named {item-name} in {project-name} in category {category-name}, with an optional first comment {comment}.
**Step 1: Resolve the project**
Call `procore-get-viewer-documents-accessible-tools` with `project-name` equal to {project-name} to resolve the project id. If nothing matches, retry with `project-name.contains`. If more than one project matches, list them with their ids and stop and ask which one. If the user named a Procore company, pass it in the `company` parameter on every call.
**Step 2: Resolve the category and look for duplicates**
Call `procore-get-punch-item-types` with the `project-id` and match {category-name} to a type. Call `procore-get-punch-items` with the `project-id` and look for an open item with the same title.
**Step 3: Confirm and create**
Show the user the exact values you will send, the project, and anything you could not resolve, and ask for an explicit yes. Do not call the write tool until the user confirms in this conversation. Then call `procore-create-punch-item` with the `project-id`, `punch-item-name` and the matched `punch-item-category-id`.
**Step 4: Add the comment**
Only if {comment} is not blank, call `procore-create-punch-item-comment` with the new item's `id` and `comment-body`.
**Step 5: Verify**
Call `procore-get-punch-items` with the `project-id` and confirm the item exists.
**Step 6: Report**
Report the new punch item title, category and status, whether the comment was added, or the exact error.
**Rules & Guidelines:**
* The only write tool you may call is `procore-create-punch-item`, and only once, after the user confirms. Do not call any other create, update, delete, send or bulk tool.
* Never invent an id, name or date. If a required value is missing or a lookup is ambiguous, ask.
* If the write fails, report the exact error and stop. Do not retry with changed values.
* The one extra write allowed is `procore-create-punch-item-comment`, only when a comment was given and the item was created.
* Do not send emails; never call `procore-send-punch-item-email` or `procore-send-unsent-punch-items`.
**Validation:**
* If the project cannot be resolved, stop and say so. Do not read records from an unresolved project.
* If the main read returns nothing, say the project has none and stop. Do not fill the gap with assumptions.
* If {category-name} matches no category or several, list the categories and stop.
Who it's for
One answer, three teams that use it
Superintendents
Log items during the walk
Add a punch item with its category and a note while you are standing in front of the defect, without scanning the list first.
Create a punch item Cracked tile in lobby on Fabrikam Depot, category Flooring, comment: grout missing along east edge.
QA and QC managers
Keep categories consistent
Every item is matched to the project's own types, so reports by category are not split across near duplicates.
Add a punch item called Fire door gap on Contoso Warehouse in category Doors and Hardware, no comment.
Project coordinators
Stop duplicate titles piling up
See an existing open item with the same title before a new one is created, so the trades are not chased twice.
Create a punch item Missing outlet cover Unit 12 on Northwind Plaza, category Electrical, but check it is not already open.
How it works
What PopdockAI does when you ask
You describe the item in plain words. Your AI assistant matches the category and creates one item, plus your comment, only after you have confirmed.
Ask
You give the item name, the project, the category and an optional first comment.
Check
It matches the category to the project's types and looks for an open item with the same title.
Confirm
You see the exact values and say yes.
Create
It creates the item once, adds the comment if given, and reads it back with category and status.
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-viewer-documents-accessible-tools
procore-get-punch-item-types
procore-get-punch-items
procore-create-punch-item
procore-create-punch-item-comment
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
Punch items that start clean, with context attached
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)
