Procore Ci Integration

Overview

Implementation patterns for Procore ci integration using the REST API with OAuth2 authentication.

Prerequisites

• Completed procore-install-auth setup

Instructions

Step 1: API Call Pattern

import os, requests

token_resp = requests.post("https://login.procore.com/oauth/token", data={
    "grant_type": "client_credentials",
    "client_id": os.environ["PROCORE_CLIENT_ID"],
    "client_secret": os.environ["PROCORE_CLIENT_SECRET"],
})
access_token = token_resp.json()["access_token"]
headers = {"Authorization": f"Bearer {access_token}"}

companies = requests.get("https://api.procore.com/rest/v1.0/companies", headers=headers)
print(f"Companies: {len(companies.json())}")

Output

• Procore API integration for ci integration

Error Handling

Resources

• Procore Developers
• REST API Reference

Next Steps

See related Procore skills for more workflows.

Procore Common Errors

Overview

Implementation patterns for Procore common errors using the REST API with OAuth2 authentication.

Prerequisites

• Completed procore-install-auth setup

Instructions

Step 1: API Call Pattern

import os, requests

token_resp = requests.post("https://login.procore.com/oauth/token", data={
    "grant_type": "client_credentials",
    "client_id": os.environ["PROCORE_CLIENT_ID"],
    "client_secret": os.environ["PROCORE_CLIENT_SECRET"],
})
access_token = token_resp.json()["access_token"]
headers = {"Authorization": f"Bearer {access_token}"}

companies = requests.get("https://api.procore.com/rest/v1.0/companies", headers=headers)
print(f"Companies: {len(companies.json())}")

Output

• Procore API integration for common errors

Error Handling

Resources

• Procore Developers
• REST API Reference

Next Steps

See related Procore skills for more workflows.

Procore Core Workflow A

Overview

Build a complete RFI workflow: create, assign, respond, track, and close RFIs using the Procore API.

Prerequisites

• Completed procore-hello-world with project access

Instructions

Step 1: Create RFI with Full Details

rfi_data = {
    "rfi": {
        "subject": "HVAC duct routing — Level 2 conflict",
        "question_body": "The HVAC ducts conflict with structural beams at grid B-4. Need routing alternatives.",
        "assignee_id": 11111,
        "rfi_manager_id": 22222,
        "due_date": "2026-04-15",
        "priority": "high",
        "cost_impact": "yes",
        "schedule_impact": "yes",
    }
}
rfi = requests.post(
    f"{BASE}/projects/{project_id}/rfis",
    headers={**headers, "Content-Type": "application/json"},
    json=rfi_data,
)
rfi_id = rfi.json()["id"]

Step 2: Add Response to RFI

response = requests.post(
    f"{BASE}/projects/{project_id}/rfis/{rfi_id}/responses",
    headers={**headers, "Content-Type": "application/json"},
    json={
        "response": {
            "body": "Route ducts below beam using 8-inch offset. See attached drawing.",
        }
    },
)

Step 3: Track RFI Status

rfi_detail = requests.get(f"{BASE}/projects/{project_id}/rfis/{rfi_id}", headers=headers)
data = rfi_detail.json()
print(f"RFI #{data['number']}: {data['status']['name']}")
print(f"  Days open: {data.get('days_open', 0)}")
print(f"  Responses: {len(data.get('responses', []))}")

Step 4: Close RFI

requests.patch(
    f"{BASE}/projects/{project_id}/rfis/{rfi_id}",
    headers={**headers, "Content-Type": "application/json"},
    json={"rfi": {"status": "closed"}},
)

Output

• RFI created with full metadata (priority, impacts, due date)
• Responses added to RFI thread
• Status tracked through lifecycle
• RFI closed upon resolution

Error Handling

Resources

Procore Core Workflow B

Overview

Build a submittal workflow: create submittals, assign reviewers, track approvals, and manage the review cycle.

Prerequisites

• Completed procore-core-workflow-a (RFIs)

Instructions

Step 1: Create Submittal

submittal = requests.post(
    f"{BASE}/projects/{project_id}/submittals",
    headers={**headers, "Content-Type": "application/json"},
    json={
        "submittal": {
            "title": "Concrete mix design — Foundation",
            "specification_section": "03 30 00",
            "description": "Concrete mix design for foundation pour, 4000 PSI.",
            "received_from_id": 33333,  # Subcontractor
            "approver_id": 44444,        # Project engineer
            "due_date": "2026-04-20",
        }
    },
)
submittal_id = submittal.json()["id"]
print(f"Submittal #{submittal.json()['number']} created")

Step 2: Update Submittal Status

# Approve the submittal
requests.patch(
    f"{BASE}/projects/{project_id}/submittals/{submittal_id}",
    headers={**headers, "Content-Type": "application/json"},
    json={"submittal": {"status_id": 2}},  # 2 = Approved
)

Step 3: List Submittals with Filters

# Get all pending submittals
pending = requests.get(
    f"{BASE}/projects/{project_id}/submittals",
    headers=headers,
    params={"filters[status_id]": 1},  # 1 = Open/Pending
)
for s in pending.json():
    print(f"  #{s['number']}: {s['title']} — Due: {s['due_date']}")

Output

• Submittals created with specification sections
• Review workflow with approve/reject
• Filtered submittal listing

Error Handling

Resources

• Submittals API
• Procore Developers

Next Steps

Handle events: procore-webhooks-events

Procore Cost Tuning

Overview

Implementation patterns for Procore cost tuning using the REST API with OAuth2 authentication.

Prerequisites

• Completed procore-install-auth setup

Instructions

Step 1: API Call Pattern

import os, requests

token_resp = requests.post("https://login.procore.com/oauth/token", data={
    "grant_type": "client_credentials",
    "client_id": os.environ["PROCORE_CLIENT_ID"],
    "client_secret": os.environ["PROCORE_CLIENT_SECRET"],
})
access_token = token_resp.json()["access_token"]
headers = {"Authorization": f"Bearer {access_token}"}

companies = requests.get("https://api.procore.com/rest/v1.0/companies", headers=headers)
print(f"Companies: {len(companies.json())}")

Output

• Procore API integration for cost tuning

Error Handling

Resources

• Procore Developers
• REST API Reference

Next Steps

See related Procore skills for more workflows.

Procore Data Handling

Overview

Implementation patterns for Procore data handling using the REST API with OAuth2 authentication.

Prerequisites

• Completed procore-install-auth setup

Instructions

Step 1: API Call Pattern

import os, requests

token_resp = requests.post("https://login.procore.com/oauth/token", data={
    "grant_type": "client_credentials",
    "client_id": os.environ["PROCORE_CLIENT_ID"],
    "client_secret": os.environ["PROCORE_CLIENT_SECRET"],
})
access_token = token_resp.json()["access_token"]
headers = {"Authorization": f"Bearer {access_token}"}

companies = requests.get("https://api.procore.com/rest/v1.0/companies", headers=headers)
print(f"Companies: {len(companies.json())}")

Output

• Procore API integration for data handling

Error Handling

Resources

• Procore Developers
• REST API Reference

Next Steps

See related Procore skills for more workflows.

Procore Debug Bundle

Overview

Implementation patterns for Procore debug bundle using the REST API with OAuth2 authentication.

Prerequisites

• Completed procore-install-auth setup

Instructions

Step 1: API Call Pattern

import os, requests

token_resp = requests.post("https://login.procore.com/oauth/token", data={
    "grant_type": "client_credentials",
    "client_id": os.environ["PROCORE_CLIENT_ID"],
    "client_secret": os.environ["PROCORE_CLIENT_SECRET"],
})
access_token = token_resp.json()["access_token"]
headers = {"Authorization": f"Bearer {access_token}"}

companies = requests.get("https://api.procore.com/rest/v1.0/companies", headers=headers)
print(f"Companies: {len(companies.json())}")

Output

• Procore API integration for debug bundle

Error Handling

Resources

• Procore Developers
• REST API Reference

Next Steps

See related Procore skills for more workflows.

Procore Deploy Integration

Overview

Implementation patterns for Procore deploy integration using the REST API with OAuth2 authentication.

Prerequisites

• Completed procore-install-auth setup

Instructions

Step 1: API Call Pattern

import os, requests

token_resp = requests.post("https://login.procore.com/oauth/token", data={
    "grant_type": "client_credentials",
    "client_id": os.environ["PROCORE_CLIENT_ID"],
    "client_secret": os.environ["PROCORE_CLIENT_SECRET"],
})
access_token = token_resp.json()["access_token"]
headers = {"Authorization": f"Bearer {access_token}"}

companies = requests.get("https://api.procore.com/rest/v1.0/companies", headers=headers)
print(f"Companies: {len(companies.json())}")

Output

• Procore API integration for deploy integration

Error Handling

Resources

• Procore Developers
• REST API Reference

Next Steps

See related Procore skills for more workflows.

Procore Enterprise Rbac

Overview

Implementation patterns for Procore enterprise rbac using the REST API with OAuth2 authentication.

Prerequisites

• Completed procore-install-auth setup

Instructions

Step 1: API Call Pattern

import os, requests

token_resp = requests.post("https://login.procore.com/oauth/token", data={
    "grant_type": "client_credentials",
    "client_id": os.environ["PROCORE_CLIENT_ID"],
    "client_secret": os.environ["PROCORE_CLIENT_SECRET"],
})
access_token = token_resp.json()["access_token"]
headers = {"Authorization": f"Bearer {access_token}"}

companies = requests.get("https://api.procore.com/rest/v1.0/companies", headers=headers)
print(f"Companies: {len(companies.json())}")

Output

• Procore API integration for enterprise rbac

Error Handling

Resources

• Procore Developers
• REST API Reference

Next Steps

See related Procore skills for more workflows.

Procore Hello World

Overview

List companies and projects, then create your first RFI using the Procore REST API.

Prerequisites

• Completed procore-install-auth with valid access token

Instructions

Step 1: List Projects

company_id = 12345  # From install-auth step
projects = requests.get(
    f"https://api.procore.com/rest/v1.0/projects?company_id={company_id}",
    headers=headers,
)
for p in projects.json():
    print(f"Project: {p['name']} (ID: {p['id']})")

Step 2: Create an RFI

project_id = 67890
rfi = requests.post(
    f"https://api.procore.com/rest/v1.0/projects/{project_id}/rfis",
    headers={**headers, "Content-Type": "application/json"},
    json={
        "rfi": {
            "subject": "Structural beam specification clarification",
            "question_body": "Please confirm the steel grade for beams on Level 3.",
            "assignee_id": 11111,  # User ID of the person to respond
        }
    },
)
rfi.raise_for_status()
print(f"RFI created: #{rfi.json()['number']} — {rfi.json()['subject']}")

Step 3: List Submittals

submittals = requests.get(
    f"https://api.procore.com/rest/v1.0/projects/{project_id}/submittals",
    headers=headers,
)
for s in submittals.json():
    print(f"Submittal #{s['number']}: {s['title']} — Status: {s['status']['name']}")

Output

• Listed companies and projects
• Created an RFI with subject and assignee
• Listed submittals with status

Error Handling

Resources

• Procore REST API
• RFIs API

Next Steps

Full RFI workflow: procore-core-workflow-a

Procore Incident Runbook

Overview

Implementation patterns for Procore incident runbook using the REST API with OAuth2 authentication.

Prerequisites

• Completed procore-install-auth setup

Instructions

Step 1: API Call Pattern

import os, requests

token_resp = requests.post("https://login.procore.com/oauth/token", data={
    "grant_type": "client_credentials",
    "client_id": os.environ["PROCORE_CLIENT_ID"],
    "client_secret": os.environ["PROCORE_CLIENT_SECRET"],
})
access_token = token_resp.json()["access_token"]
headers = {"Authorization": f"Bearer {access_token}"}

companies = requests.get("https://api.procore.com/rest/v1.0/companies", headers=headers)
print(f"Companies: {len(companies.json())}")

Output

• Procore API integration for incident runbook

Error Handling

Resources

• Procore Developers
• REST API Reference

Next Steps

See related Procore skills for more workflows.

Procore Install Auth

Overview

Set up Procore API authentication using OAuth2 client credentials flow. Procore uses OAuth2 with separate endpoints for production and sandbox.

Prerequisites

• Procore Developer account at developers.procore.com
• App credentials (clientid, clientsecret)
• A Procore company to authorize against

Instructions

Step 1: Register Application

1. Go to developers.procore.com > My Apps > Create App
2. Set redirect URI: http://localhost:3000/callback
3. Copy client_id and client_secret

Step 2: Configure Environment

# .env
PROCORE_CLIENT_ID=your_client_id
PROCORE_CLIENT_SECRET=your_client_secret
PROCORE_BASE_URL=https://api.procore.com
# For sandbox: https://sandbox.procore.com

Step 3: Client Credentials Flow

import os, requests

token_resp = requests.post("https://login.procore.com/oauth/token", data={
    "grant_type": "client_credentials",
    "client_id": os.environ["PROCORE_CLIENT_ID"],
    "client_secret": os.environ["PROCORE_CLIENT_SECRET"],
})
token_resp.raise_for_status()
access_token = token_resp.json()["access_token"]

# Verify — list companies
headers = {"Authorization": f"Bearer {access_token}"}
companies = requests.get("https://api.procore.com/rest/v1.0/companies", headers=headers)
companies.raise_for_status()
for co in companies.json():
    print(f"Company: {co['name']} (ID: {co['id']})")

Output

• OAuth2 tokens obtained via client credentials
• API connectivity verified with company listing

Error Handling

Resources

• Procore OAuth Endpoints
• Client Credentials

Next Steps

First API call: procore-hello-world

Procore Local Dev Loop

Overview

Implementation patterns for Procore local dev loop using the REST API with OAuth2 authentication.

Prerequisites

• Completed procore-install-auth setup

Instructions

Step 1: API Call Pattern

import os, requests

token_resp = requests.post("https://login.procore.com/oauth/token", data={
    "grant_type": "client_credentials",
    "client_id": os.environ["PROCORE_CLIENT_ID"],
    "client_secret": os.environ["PROCORE_CLIENT_SECRET"],
})
access_token = token_resp.json()["access_token"]
headers = {"Authorization": f"Bearer {access_token}"}

companies = requests.get("https://api.procore.com/rest/v1.0/companies", headers=headers)
print(f"Companies: {len(companies.json())}")

Output

• Procore API integration for local dev loop

Error Handling

Resources

• Procore Developers
• REST API Reference

Next Steps

See related Procore skills for more workflows.

Procore Migration Deep Dive

Overview

Implementation patterns for Procore migration deep dive using the REST API with OAuth2 authentication.

Prerequisites

• Completed procore-install-auth setup

Instructions

Step 1: API Call Pattern

import os, requests

token_resp = requests.post("https://login.procore.com/oauth/token", data={
    "grant_type": "client_credentials",
    "client_id": os.environ["PROCORE_CLIENT_ID"],
    "client_secret": os.environ["PROCORE_CLIENT_SECRET"],
})
access_token = token_resp.json()["access_token"]
headers = {"Authorization": f"Bearer {access_token}"}

companies = requests.get("https://api.procore.com/rest/v1.0/companies", headers=headers)
print(f"Companies: {len(companies.json())}")

Output

• Procore API integration for migration deep dive

Error Handling

Resources

• Procore Developers
• REST API Reference

Next Steps

See related Procore skills for more workflows.

Procore Multi Env Setup

Overview

Implementation patterns for Procore multi env setup using the REST API with OAuth2 authentication.

Prerequisites

• Completed procore-install-auth setup

Instructions

Step 1: API Call Pattern

import os, requests

token_resp = requests.post("https://login.procore.com/oauth/token", data={
    "grant_type": "client_credentials",
    "client_id": os.environ["PROCORE_CLIENT_ID"],
    "client_secret": os.environ["PROCORE_CLIENT_SECRET"],
})
access_token = token_resp.json()["access_token"]
headers = {"Authorization": f"Bearer {access_token}"}

companies = requests.get("https://api.procore.com/rest/v1.0/companies", headers=headers)
print(f"Companies: {len(companies.json())}")

Output

• Procore API integration for multi env setup

Error Handling

Resources

• Procore Developers
• REST API Reference

Next Steps

See related Procore skills for more workflows.

Procore Observability

Overview

Implementation patterns for Procore observability using the REST API with OAuth2 authentication.

Prerequisites

• Completed procore-install-auth setup

Instructions

Step 1: API Call Pattern

import os, requests

token_resp = requests.post("https://login.procore.com/oauth/token", data={
    "grant_type": "client_credentials",
    "client_id": os.environ["PROCORE_CLIENT_ID"],
    "client_secret": os.environ["PROCORE_CLIENT_SECRET"],
})
access_token = token_resp.json()["access_token"]
headers = {"Authorization": f"Bearer {access_token}"}

companies = requests.get("https://api.procore.com/rest/v1.0/companies", headers=headers)
print(f"Companies: {len(companies.json())}")

Output

• Procore API integration for observability

Error Handling

Resources

• Procore Developers
• REST API Reference

Next Steps

See related Procore skills for more workflows.

Procore Performance Tuning

Overview

Implementation patterns for Procore performance tuning using the REST API with OAuth2 authentication.

Prerequisites

• Completed procore-install-auth setup

Instructions

Step 1: API Call Pattern

import os, requests

token_resp = requests.post("https://login.procore.com/oauth/token", data={
    "grant_type": "client_credentials",
    "client_id": os.environ["PROCORE_CLIENT_ID"],
    "client_secret": os.environ["PROCORE_CLIENT_SECRET"],
})
access_token = token_resp.json()["access_token"]
headers = {"Authorization": f"Bearer {access_token}"}

companies = requests.get("https://api.procore.com/rest/v1.0/companies", headers=headers)
print(f"Companies: {len(companies.json())}")

Output

• Procore API integration for performance tuning

Error Handling

Resources

• Procore Developers
• REST API Reference

Next Steps

See related Procore skills for more workflows.

Procore Prod Checklist

Overview

Implementation patterns for Procore prod checklist using the REST API with OAuth2 authentication.

Prerequisites

• Completed procore-install-auth setup

Instructions

Step 1: API Call Pattern

import os, requests

token_resp = requests.post("https://login.procore.com/oauth/token", data={
    "grant_type": "client_credentials",
    "client_id": os.environ["PROCORE_CLIENT_ID"],
    "client_secret": os.environ["PROCORE_CLIENT_SECRET"],
})
access_token = token_resp.json()["access_token"]
headers = {"Authorization": f"Bearer {access_token}"}

companies = requests.get("https://api.procore.com/rest/v1.0/companies", headers=headers)
print(f"Companies: {len(companies.json())}")

Output

• Procore API integration for prod checklist

Error Handling

Resources

• Procore Developers
• REST API Reference

Next Steps

See related Procore skills for more workflows.

Procore Rate Limits

Overview

Implementation patterns for Procore rate limits using the REST API with OAuth2 authentication.

Prerequisites

• Completed procore-install-auth setup

Instructions

Step 1: API Call Pattern

import os, requests

token_resp = requests.post("https://login.procore.com/oauth/token", data={
    "grant_type": "client_credentials",
    "client_id": os.environ["PROCORE_CLIENT_ID"],
    "client_secret": os.environ["PROCORE_CLIENT_SECRET"],
})
access_token = token_resp.json()["access_token"]
headers = {"Authorization": f"Bearer {access_token}"}

companies = requests.get("https://api.procore.com/rest/v1.0/companies", headers=headers)
print(f"Companies: {len(companies.json())}")

Output

• Procore API integration for rate limits

Error Handling

Resources

• Procore Developers
• REST API Reference

Next Steps

See related Procore skills for more workflows.

Procore Reference Architecture

Overview

Implementation patterns for Procore reference architecture using the REST API with OAuth2 authentication.

Prerequisites

• Completed procore-install-auth setup

Instructions

Step 1: API Call Pattern

import os, requests

token_resp = requests.post("https://login.procore.com/oauth/token", data={
    "grant_type": "client_credentials",
    "client_id": os.environ["PROCORE_CLIENT_ID"],
    "client_secret": os.environ["PROCORE_CLIENT_SECRET"],
})
access_token = token_resp.json()["access_token"]
headers = {"Authorization": f"Bearer {access_token}"}

companies = requests.get("https://api.procore.com/rest/v1.0/companies", headers=headers)
print(f"Companies: {len(companies.json())}")

Output

• Procore API integration for reference architecture

Error Handling

Resources

• Procore Developers
• REST API Reference

Next Steps

See related Procore skills for more workflows.

Procore Sdk Patterns

Overview

Implementation patterns for Procore sdk patterns using the REST API with OAuth2 authentication.

Prerequisites

• Completed procore-install-auth setup

Instructions

Step 1: API Call Pattern

import os, requests

token_resp = requests.post("https://login.procore.com/oauth/token", data={
    "grant_type": "client_credentials",
    "client_id": os.environ["PROCORE_CLIENT_ID"],
    "client_secret": os.environ["PROCORE_CLIENT_SECRET"],
})
access_token = token_resp.json()["access_token"]
headers = {"Authorization": f"Bearer {access_token}"}

companies = requests.get("https://api.procore.com/rest/v1.0/companies", headers=headers)
print(f"Companies: {len(companies.json())}")

Output

• Procore API integration for sdk patterns

Error Handling

Resources

• Procore Developers
• REST API Reference

Next Steps

See related Procore skills for more workflows.

Procore Security Basics

Overview

Implementation patterns for Procore security basics using the REST API with OAuth2 authentication.

Prerequisites

• Completed procore-install-auth setup

Instructions

Step 1: API Call Pattern

import os, requests

token_resp = requests.post("https://login.procore.com/oauth/token", data={
    "grant_type": "client_credentials",
    "client_id": os.environ["PROCORE_CLIENT_ID"],
    "client_secret": os.environ["PROCORE_CLIENT_SECRET"],
})
access_token = token_resp.json()["access_token"]
headers = {"Authorization": f"Bearer {access_token}"}

companies = requests.get("https://api.procore.com/rest/v1.0/companies", headers=headers)
print(f"Companies: {len(companies.json())}")

Output

• Procore API integration for security basics

Error Handling

Resources

• Procore Developers
• REST API Reference

Next Steps

See related Procore skills for more workflows.

Procore Upgrade Migration

Overview

Implementation patterns for Procore upgrade migration using the REST API with OAuth2 authentication.

Prerequisites

• Completed procore-install-auth setup

Instructions

Step 1: API Call Pattern

import os, requests

token_resp = requests.post("https://login.procore.com/oauth/token", data={
    "grant_type": "client_credentials",
    "client_id": os.environ["PROCORE_CLIENT_ID"],
    "client_secret": os.environ["PROCORE_CLIENT_SECRET"],
})
access_token = token_resp.json()["access_token"]
headers = {"Authorization": f"Bearer {access_token}"}

companies = requests.get("https://api.procore.com/rest/v1.0/companies", headers=headers)
print(f"Companies: {len(companies.json())}")

Output

• Procore API integration for upgrade migration

Error Handling

Resources

• Procore Developers
• REST API Reference

Next Steps

See related Procore skills for more workflows.

Procore Webhooks Events

Overview

Implementation patterns for Procore webhooks events using the REST API with OAuth2 authentication.

Prerequisites

• Completed procore-install-auth setup

Instructions

Step 1: API Call Pattern

import os, requests

token_resp = requests.post("https://login.procore.com/oauth/token", data={
    "grant_type": "client_credentials",
    "client_id": os.environ["PROCORE_CLIENT_ID"],
    "client_secret": os.environ["PROCORE_CLIENT_SECRET"],
})
access_token = token_resp.json()["access_token"]
headers = {"Authorization": f"Bearer {access_token}"}

companies = requests.get("https://api.procore.com/rest/v1.0/companies", headers=headers)
print(f"Companies: {len(companies.json())}")

Output

• Procore API integration for webhooks events

Error Handling

Resources

• Procore Developers
• REST API Reference

Next Steps

See related Procore skills for more workflows.