CoConstruct API
CoConstruct is project management and financial software used by custom home builders and remodelers to run jobs end-to-end. An unofficial API lets you programmatically pull project lists, clients and trade partners, selections and allowances, change orders, budgets and purchase order
What is CoConstruct?
CoConstruct is a cloud platform for residential construction management that centralizes preconstruction, project execution, financials, and client/trade communications. Builders use CoConstruct to estimate and budget, manage client selections and allowances, issue change orders and purchase orders, sync with accounting, schedule work, track time, and collaborate via a client/trade partner portal.
Core product areas include:
- Preconstruction & Sales (e.g., Leads, Proposals, Estimates, Bid Requests)
- Project Management (e.g., Schedules, To-Dos, Daily Logs, Warranty/Punch)
- Financials (e.g., Budgets, Selections & Allowances, Change Orders, Purchase Orders, Client Invoices, QuickBooks Sync)
- Collaboration & Documents (e.g., Client/Trade Partner Portal, Messages, Photos/Files)
Common data entities:
- Companies, Users, Clients, and Trade Partners
- Projects (metadata, addresses, dates, status)
- Selections & Allowances (categories, options, chosen items, pricing)
- Budgets, Estimates, Cost Codes, Cost Categories
- Change Orders (scope, line items, markups, approvals)
- Purchase Orders (commitments to trades/vendors)
- Invoices and Payments (often synced to QuickBooks)
- Bid Packages and Responses
- Schedules and Tasks
- Timesheets and Labor Entries
- To-Dos, Warranty Tickets, Messages, Photos, Attachments
The CoConstruct Integration Challenge
CoConstruct is built for builders and their clients/trade partners, but transforming portal-first workflows into reliable automation is nuanced:
- Role- and portal-specific flows: Clients, builders, and trades see different data and approval states for selections, change orders, and schedules
- Financial rigor: Allowances, markups, taxes, and approval histories must be computed and respected programmatically
- Accounting sync: QuickBooks mappings (customers:jobs, items, classes, cost codes) require careful normalization
- Portal-first features: Many capabilities are optimized for the web app; data is distributed across views, exports, and attachments
- Authentication and session maintenance: Handling MFA and session rotation reliably without user interaction
- Large artifacts: Photos/files need staged uploads, time-limited URLs, and checksum validation
How Supergood Creates CoConstruct APIs
Supergood reverse-engineers authenticated browser flows and network interactions to deliver a resilient API endpoint layer for your CoConstruct tenant.
- Handles username/password, SSO/OAuth, and MFA (SMS, email, TOTP) securely
- Maintains session continuity with automated refresh and change detection
- Normalizes responses so you can integrate once and rely on consistent objects across modules
- Aligns with customer entitlements and role-based permissions to ensure compliant access
Getting Started
- Schedule Integration Assessment
Book a 30-minute session to confirm your modules, licensing, and authentication model.
- Supergood Builds and Validates Your API
We deliver a hardened CoConstruct adapter tailored to your workflows and entitlements.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adjustments as CoConstruct evolves.
API Endpoints
Authentication
/sessionsEstablish a session using credentials. Supergood manages MFA (SMS, email, TOTP) and SSO/OAuth when enabled. Returns a short-lived auth token maintained by the platform.
Authentication
/sessions/refreshRefresh an existing token to keep sessions uninterrupted.
Projects
/projectsList projects with filters and summary details.
Selections
/projects/{projectId}/selectionsList selection items, allowance balances, options, and client choices.
Change Orders
/projects/{projectId}/change-ordersCreate a client-facing change order with line items, markups, and optional approval requirements.
Purchase Orders
/projects/{projectId}/purchase-ordersIssue a purchase order to a trade/vendor with cost-coded line items.
Use Cases
Project and Contact Sync
- Mirror projects, clients, and trade partners into your internal systems - Keep status, dates, addresses, and cost codes up to date for analytics and reporting - Normalize job numbers and company records across multi-tenant operations
Selections and Allowance Automation
- Pull selection categories, options, and allowance balances to power client experiences - Create or update selections and capture client approvals in your product - Trigger orders or POs when selections are finalized; manage lead times and due dates
Financials: Budgets, Change Orders, and Purchase Orders
- Generate and submit client-visible change orders with line items, markups, and taxes - Push purchase orders to trade partners from your procurement system - Pull financial statuses and totals to reconcile with ERP/accounting (e.g., QuickBooks)
Scheduling and Time Tracking
- Ingest schedules and tasks to coordinate field crews and subcontractors - Log timesheets with cost codes from your time clock or mobile app - Drive notifications and approvals when schedule or labor thresholds are met
Technical Specifications
Authentication
Username/password with MFA (SMS, email, TOTP) and SSO/OAuth where enabled; supports service accounts or customer-managed credentials
Response format
JSON with consistent resource schemas and pagination across modules
Rate limits
Tuned for enterprise throughput while honoring customer entitlements and usage controls
Session management
Automatic reauth and cookie/session rotation with health checks
Data freshness
Near real-time retrieval of projects, selections, change orders, purchase orders, schedules, and timesheets
Security
Encrypted transport, scoped tokens, and audit logging; respects CoConstruct role-based permissions
Webhooks
Optional asynchronous delivery for long-running workflows (e.g., client approvals, PO issuance)
Latency
Sub-second responses for list/detail queries under normal load
Throughput
Designed for high-volume project sync and financial document processing
Reliability
Retry logic, backoff, and idempotency keys minimize duplicate actions
Adaptation
Continuous monitoring for UI changes with rapid adapter updates
Frequently asked questions
Supergood supports workflows across commonly used modules such as Selections & Allowances, Financials (Budgets, Change Orders, Purchase Orders, Invoices), Scheduling & Timesheets, and Collaboration (Messages, Photos/Files), subject to your licensing and entitlements. We scope coverage during integration assessment.
We support username/password + MFA (SMS, email, TOTP) and can operate behind SSO/OAuth when enabled. Sessions are refreshed automatically with secure challenge handling.
Yes. We can normalize budgets, cost codes, and financial documents (change orders, POs, invoices) to match your ERP schema and deliver updates via webhooks or polling while complying with rate and permission constraints.
Yes. We support listing and updating selection choices, surfacing allowance balances, and handling attachments via signed uploads, with checksum validation and time-limited URLs.