Connectors

/

Procore

/

Create Procore punch item with comment
Write

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.

Try PopdockAI free
Get a live demo
Create Procore punch item with comment
Add a punch item called Paint touch up Level 2 corridor on Riverside Tower, category Finishes, comment: see photos from Tuesday's walk.
Riverside Tower has no open punch item called Paint touch up Level 2 corridor, so this will be a new one. - Category: Finishes (one match) - Title: Paint touch up Level 2 corridor - First comment: see photos from Tuesday's walk - Emails: none will be sent Shall I create it?
Procore
Sample figures. Your results come from your own account.
procore-get-viewer-documents-accessible-tools
procore-get-punch-item-types
procore-get-punch-items
procore-create-punch-item
procore-create-punch-item-comment

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

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.

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

Your AI tool

Check

It matches the category to the project's types and looks for an open item with the same title.

procore-get-viewer-documents-accessible-tools
procore-get-punch-item-types
procore-get-punch-items

Confirm

You see the exact values and say yes.

No items found.

Create

It creates the item once, adds the comment if given, and reads it back with category and status.

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-viewer-documents-accessible-tools

Returns Procore viewer documents accessible tools records from the Project Management area. Filter by project and by the record's own fields; reads only, nothing is changed.
get-data

procore-get-punch-item-types

Returns Procore punch item types records from the Project Management area. Filter by project and by the record's own fields; reads only, nothing is changed.
get-data

procore-get-punch-items

Returns Procore punch list items for a project, with status, assignee, due date and cost impact.
run-action

procore-create-punch-item

Create punch item in Procore, under punch items (POST). This is a write tool: it is built Inactive and has not been run end to end through MCP, so test it in a Procore sandbox before switching it on.
run-action

procore-create-punch-item-comment

Create punch item comment in Procore, under punch items (POST). This is a write tool: it is built Inactive and has not been run end to end through MCP, so test it in a Procore sandbox before switching it on.
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

Punch items that start clean, with context attached

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