Buildertrend

Supergood | Buildertrend API

Alex Klarfeld

Alex Klarfeld

— 6 min read
Supergood | Buildertrend API

Programmatically access Buildertrend construction project data, client selections, schedules, and financial workflows with a stable REST API. Supergood builds and operates production-grade, unofficial Buildertrend integrations so your team can automate field and office processes without heavy custom engineering.

Plain English: Buildertrend is construction management software designed for home builders, remodelers, and specialty contractors to run jobs end-to-end. An unofficial API lets you programmatically pull project lists, customers, schedules, selections, change orders, budgets, purchase orders, daily logs, time entries, and documents—and push new records or updates back into Buildertrend.

For a tech company integrating with Buildertrend, this means you can ingest real-time job and customer data to power dashboards, sync change orders and purchase orders to accounting (e.g., QuickBooks, Xero), automate selections and approvals from your product, or enrich your platform with schedules, field logs, and photos. You can also trigger client-facing updates, invite trades to bid, create daily logs from field sensors, attach documents, and keep stakeholder systems (ERP, analytics, CRM, scheduling) in lockstep.

What is Buildertrend?

Buildertrend (https://buildertrend.com/) is a cloud platform for residential construction management that centralizes project execution, customer communication, job financials, and field operations across builders, remodelers, clients, and trade partners. Teams use Buildertrend to manage estimates and budgets, track schedules and daily logs, coordinate selections and change orders with homeowners, process purchase orders and invoices, and manage warranty/service requests—all with a client and subcontractor portal for collaboration.

Core product areas include:

  • Project Management (Projects, Schedules, Tasks, Daily Logs, To-Dos, Photos, Documents)
  • Financials (Estimates, Budgets, Cost Codes, Purchase Orders, Vendor Bills/Invoices, Client Change Orders, Payments)
  • Customer Experience (Client Portal, Selections, Messages, Approvals, E-Signatures)
  • Trade Partner Management (Bids, Subcontractors/Vendors, Work Orders)
  • Field Operations (Time Clock/Timesheets, Warranty/Service Requests, Checklists)

Common data entities:

  • Companies, Users, Roles/Permissions (Builder Staff, Client/Homeowner, Trade Partner)
  • Projects (metadata, addresses, job numbers, phases/status)
  • Clients/Customers (contact info, preferences)
  • Schedules and Tasks (dates, dependencies, assignments)
  • Selections (categories, options, pricing, approvals)
  • Change Orders (line items, taxes, signatures, status)
  • Budgets and Cost Codes (job costing, line items, variance)
  • Purchase Orders and Vendor Invoices (commitments, receipts)
  • Daily Logs (notes, weather, labor/equipment, photos)
  • Time Entries/Timesheets (users, hours, cost codes)

The Buildertrend Integration Challenge

Residential construction teams rely on Buildertrend every day, but turning portal-based workflows into API-driven automation is non-trivial:

  • Role-aware portals: Builders, clients, and trade partners each see different data and approval states
  • Financial rigor: Budgets, cost codes, taxes, and client change order approvals require careful handling
  • Portal-first features: Selections, warranty, and messaging are optimized for front-end flows
  • Authentication complexity: SSO/MFA and session lifecycles complicate headless automation
  • Data spread: Key objects span schedules, selections, change orders, and financials with context in multiple views

How Supergood Creates Buildertrend APIs

Supergood reverse-engineers authenticated browser flows and network interactions to deliver a resilient API endpoint layer for your Buildertrend 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

Use Cases

Project & Customer Data Sync

  • Mirror projects, clients, and trade partners into your internal systems
  • Keep project metadata current for analytics and reporting
  • Normalize addresses, statuses, and job numbers for multi-tenant operations

Selections & Change Order Automation

  • Create selection groups and options from your product catalog
  • Trigger client approvals and e-signature workflows for change orders
  • Track status to drive SLA alerts and push updates back to Buildertrend

Schedules & Field Reporting

  • Sync task schedules and dependencies with your planning tools
  • Ingest daily logs for workforce, equipment, and notes
  • Attach photos and documents, unify QA/QC workflows, and drive follow-ups

Financials: Budgets, POs, and Accounting Sync

  • Generate purchase orders from procurement flows
  • Pull change order status and totals to reconcile with ERP/accounting (e.g., QuickBooks, Xero)
  • Normalize cost codes, taxes, and line items across projects

Available Endpoints

Authentication

POST /sessions: Establish 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.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/sessions \
  --header 'Authorization: Basic <Base64 encoded token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "username": "[email protected]",
    "password": "<password>",
    "mfa": { "type": "totp", "code": "123456" }
  }'

Example response

{
  "authToken": "eyJhbGciOi...",
  "expiresIn": 3600,
  "user": {
    "id": "u_bldr_729c10",
    "name": "Project Manager",
    "entitlements": ["projects", "schedules", "selections", "change_orders", "financials"]
  }
}

POST /sessions/refresh: Refresh an existing token to keep sessions uninterrupted.

Projects

GET /projects: List projects with filters and summary details.

Query parameters

  • companyId: string
  • customerId: string
  • status: active | archived | closed | prospect
  • updatedFrom, updatedTo: ISO 8601 timestamps
  • page, pageSize: integers for pagination

Example response

{
  "items": [
    {
      "projectId": "prj_2a91f0",
      "name": "Lakeview Custom Home",
      "jobNumber": "LV-2026-004",
      "type": "new_construction",
      "status": "active",
      "customerId": "cust_88b32e",
      "customerName": "Jordan & Casey Smith",
      "address": {
        "line1": "125 Lakeview Ct",
        "city": "Omaha",
        "region": "NE",
        "postalCode": "68130",
        "country": "US"
      },
      "contractAmount": 950000.00,
      "approvedChangeOrdersTotal": 42000.00,
      "startDate": "2026-01-15",
      "endDate": null,
      "updatedAt": "2026-01-20T13:45:00Z"
    }
  ],
  "page": 1,
  "pageSize": 50,
  "total": 1
}

Selections

POST /projects/{projectId}/selections: Create a selection group with client-facing options and pricing.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/projects/prj_2a91f0/selections \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "title": "Primary Bath Tile",
    "category": "Flooring",
    "dueDate": "2026-02-10",
    "choiceType": "single",
    "required": true,
    "allowPriceVisibility": true,
    "options": [
      {"optionCode": "TL-HEX-WHT", "name": "Hex White Porcelain", "price": 1200.00, "vendorId": "ven_451293"},
      {"optionCode": "TL-PRSL-GRY", "name": "Large Format Gray Porcelain", "price": 1450.00, "vendorId": "ven_451293"}
    ],
    "defaultOptionCode": "TL-HEX-WHT",
    "notes": "Prices include standard install; custom pattern extra.",
    "attachments": [
      {"fileName": "tile_specs.pdf", "uploadToken": "upl_08ab73"}
    ],
    "notifyClient": true
  }'

Example response

{
  "selectionId": "sel_90e412",
  "status": "open",
  "optionCount": 2,
  "createdAt": "2026-01-21T10:03:11Z"
}

Change Orders

POST /projects/{projectId}/change-orders: Create a client change order with line items, taxes, and approval metadata.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/projects/prj_2a91f0/change-orders \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "title": "Upgrade Kitchen Cabinets",
    "description": "Change to full overlay shaker cabinets, soft-close hardware.",
    "reason": "client_request",
    "items": [
      {"costCodeId": "cc_064100", "description": "Cabinet Materials", "quantity": 1, "unit": "lot", "unitPrice": 8200.00, "taxRate": 7.5},
      {"costCodeId": "cc_064100", "description": "Install Labor", "quantity": 1, "unit": "lot", "unitPrice": 1800.00, "taxRate": 0.0}
    ],
    "estimatedScheduleImpactDays": 2,
    "requiresSignature": true,
    "customerVisible": true,
    "notes": "Includes soft-close hinges and full-depth shelves.",
    "attachments": [
      {"fileName": "cabinet_quote.pdf", "uploadToken": "upl_7fa223"}
    ],
    "referenceId": "crm-opp-2981"
  }'

Example response

{
  "changeOrderId": "co_51af80",
  "number": 12,
  "status": "awaiting_approval",
  "total": 10000.00,
  "taxTotal": 615.00,
  "createdAt": "2026-01-21T11:20:44Z"
}

Schedule Tasks

PATCH /projects/{projectId}/schedule/tasks/{taskId}: Update task dates, dependencies, and progress.

curl --request PATCH \
  --url https://api.supergood.ai/integrations/<integration_id>/projects/prj_2a91f0/schedule/tasks/tsk_7c3d21 \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "startDate": "2026-02-01",
    "endDate": "2026-02-03",
    "percentComplete": 50,
    "predecessors": [
      {"taskId": "tsk_3a10f0", "type": "FS", "lagDays": 1}
    ],
    "assignedToVendorId": "ven_9ab441",
    "notes": "Tile delivery delayed one day; schedule adjusted."
  }'

Example response

{
  "taskId": "tsk_7c3d21",
  "status": "in_progress",
  "startDate": "2026-02-01",
  "endDate": "2026-02-03",
  "percentComplete": 50,
  "updatedAt": "2026-01-22T08:15:12Z"
}

Get full API Specs →

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, schedules, selections, change orders, and financial objects
  • Security: Encrypted transport, scoped tokens, and audit logging; respects Buildertrend role-based permissions
  • Webhooks: Optional asynchronous delivery for long-running workflows (e.g., client approvals, schedule changes)

Performance Characteristics

  • Latency: Sub-second responses for list/detail queries under normal load
  • Throughput: Designed for high-volume project data sync and change order/selection processing
  • Reliability: Retry logic, backoff, and idempotency keys minimize duplicate actions
  • Adaptation: Continuous monitoring for UI/API changes with rapid adapter updates

Getting Started

  1. Schedule Integration Assessment

Book a 30-minute session to confirm your modules, licensing, and authentication model.

  1. Supergood Builds and Validates Your API

We deliver a hardened Buildertrend adapter tailored to your workflows and entitlements.

  1. Deploy with Monitoring

Go live with continuous monitoring and automatic adjustments as Buildertrend evolves.

Schedule Integration Call →

Frequently Asked Questions

Q: Which Buildertrend modules can this integration cover?

Supergood supports workflows across commonly used modules such as Project Management (Schedules, Tasks, Daily Logs), Financials (Budgets, Purchase Orders, Client Change Orders, Vendor Invoices), and Customer Experience (Selections, Client Portal), subject to your licensing and entitlements. We scope coverage during integration assessment.

Q: How are MFA and SSO handled for automation?

We support username/password + MFA (SMS, email, TOTP) and can operate behind SSO/OAuth when enabled. Sessions are refreshed automatically with secure challenge handling.

Q: Can you sync purchase orders and change orders to our accounting system?

Yes. We can normalize POs, change orders, and job-cost line items to match your ERP/accounting schema (e.g., cost codes, taxes) and deliver updates via webhooks or polling while complying with rate and permission constraints. We commonly integrate with QuickBooks and Xero.

Q: Are client approvals and signatures supported for selections and change orders?

Yes. We support downloading approval artifacts and uploading attachments via signed uploads, with checksum validation and time-limited URLs. Approval states and signature requirements are modeled explicitly in our normalized responses.

Ready to automate your Buildertrend workflows?

Supergood can have your Buildertrend integration live in days with no ongoing engineering maintenance.

Get Started →

Read more