eSUB API
eSUB is a cloud construction project management platform purpose-built for commercial subcontractors, covering daily reports, RFIs, submittals, change orders, document control, time tracking, and job costing. An unofficial API lets you programmatically pull projects, daily reports, RFIs, submittals, change orders, and time entries—and push updates like new field notes, change orders, and labor records back into eSUB.
What is eSUB?
eSUB is a cloud construction project management platform built specifically for commercial subcontractors across the electrical, HVAC, plumbing, mechanical, masonry, concrete, structural steel, and drywall trades. Subcontractors use eSUB to capture daily reports and field documentation, manage RFIs and submittals, process change orders, control drawings and documents, track time and materials, and run job costing—connecting field crews to the back office through cloud and mobile apps. Fusion by eSUB is the company's modern connected-jobsite offering linking field personnel to back-office operations.
Core product areas include:
- Daily Reports and field documentation
- Project Management, RFIs, and Submittals
- Change Orders and Time & Materials tracking
- Document Control and drawing management
- Purchase Orders and Job Costing
- Time Management, Reporting, and Analytics
- Fusion by eSUB connected-jobsite tools
Common data entities:
- Projects, Companies, Contacts, Users
- Daily Reports, Field Notes, Field Communications
- RFIs, Submittals, Drawings, Documents
- Change Orders, Purchase Orders, Time & Materials
- Time Entries, Labor, Job Costs, Cost Codes
The eSUB Integration Challenge
Subcontractors run mission-critical field-to-office workflows on eSUB daily, but turning portal- and mobile-driven workflows into API-driven automation is non-trivial:
- Mobile-first field data: Much of the most valuable data—daily reports, field notes, time entries—is captured in mobile apps and isn't exposed through a documented public REST API
- No documented public API: eSUB exposes integrations through partner connectors (QuickBooks Online, Autodesk BIM 360/Forge) rather than an open, self-serve developer API
- Partner ecosystem gates: BIM 360 and accounting flows ride on Autodesk Forge OAuth and pre-built connectors, requiring partnership setup before data access
- Project-by-project structure: Cost codes, document folders, and workflow states are configured per project, so generic integrations break across jobs
- Document and drawing workflows: RFIs, submittals, change orders, and field notes carry attachments and drawing markups that need careful upload/download handling
- Authentication complexity: Session-based logins and per-user entitlements complicate headless automation against the platform
How Supergood Creates eSUB APIs
Supergood reverse-engineers eSUB's authenticated web and mobile flows to deliver a resilient API layer for your eSUB account—covering projects, daily reports, RFIs, submittals, change orders, and time entries that no documented public API exposes.
- Handles username/password and MFA securely in a managed session
- Maintains session continuity with automated refresh and change detection
- Normalizes responses across Projects, Daily Reports, RFIs, Submittals, Change Orders, and Time Entries so you integrate once and rely on consistent objects
- Aligns with project-specific cost codes, document folders, and entitlements to ensure compliant access
Use eSUB with AI agents: eSUB MCP Server →
Getting Started
- Schedule Integration Assessment
Book a 30-minute session to confirm your modules, projects, and authentication model.
- Supergood Generates and Validates Your API
We deliver a production-ready eSUB adapter tailored to your account configuration and entitlements.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adjustments as eSUB evolves.
API Endpoints
Authentication
/authenticateAuthenticate to an eSUB account using username/password, or MFA and obtain a session token for downstream calls.
Projects
/projectsList projects with filters for company, status, and date range, including cost codes and document folder structure.
Field Operations
/daily_reportsRetrieve daily reports and field notes with crew, weather, labor, and attachment details.
Field Operations
/create_daily_reportCreate a daily report or field note against a project with crew, hours, and supporting documents.
Project Documents
/rfisPull RFIs and submittals with status, assignment, due-date, and attached drawing markups.
Change Management
/create_change_orderSubmit a new change order against a project with cost items, markups, and approval routing.
Use Cases
Sync project and field data into the back office
- Pull projects, daily reports, and field notes from eSUB into a central warehouse - Stream labor, time, and material entries to job-costing and ERP systems - Reconcile crew and contact records across projects for unified reporting
Automate RFI and submittal workflows
- Pull open RFIs and submittals with due dates and assignments for tracking dashboards - Push new RFIs and submittal responses without portal clicks - Route overdue items and approvals to project managers automatically
Reconcile change orders and job costs
- Sync change orders, purchase orders, and time & materials into accounting and analytics - Match labor and material costs against project cost codes - Surface change-order revenue and pending approvals to finance workflows
Keep documents and drawings in sync
- Mirror document control folders and drawing markups into a DMS or BIM environment - Link field notes, RFIs, and change orders to plans and models - Trigger downstream notifications when drawings or documents change
Technical Specifications
Authentication
Username/password and MFA handled in a managed session
Connectivity
Authenticated web and mobile flows plus partner connectors (QuickBooks Online, Autodesk Forge/BIM 360) where exposed by the account
Response format
Normalized JSON across Projects, Daily Reports, RFIs, Submittals, Change Orders, and Time Entries
Rate limits
Adaptive throttling tuned to your account to avoid platform-side limits
Session management
Automatic session refresh, MFA replay handling, and credential rotation
Data freshness
Near real-time pulls for daily reports, RFIs, and change orders with optional scheduled batch syncs
Security
Encrypted credential vault, scoped access tokens, SOC 2-aligned controls, and audit logging
Webhooks
Event-style callbacks for new daily reports, RFI status, submittal updates, and change-order approvals
Latency
Sub-second reads on cached entities; multi-second writes when posting field reports and change orders
Throughput
Horizontally scaled workers sized to multi-project, multi-crew volume
Reliability
Retry, backoff, and idempotency keys for change orders, time entries, and document uploads
Adaptation
Continuous monitoring of eSUB releases, Fusion changes, and project-specific configuration drift
Frequently asked questions
eSUB does not publish an open, self-serve developer API; integrations flow through partner connectors like QuickBooks Online and Autodesk Forge/BIM 360. Supergood works against the authenticated web and mobile surfaces to give you programmatic access to projects, daily reports, RFIs, submittals, change orders, and time entries.
Yes. Daily reports, field notes, time entries, and field communications captured in the eSUB mobile apps are exposed through the same normalized API surface, so field-to-office data sits alongside project and document entities.
Each account is profiled against its configured cost codes, document folders, and workflow states. Supergood preserves project-specific fields and entitlements rather than forcing a generic schema.
Yes. Supergood complements eSUB's existing partner connectors. You can keep your QuickBooks Online accounting sync and BIM 360 document flows while using Supergood for the broader project, RFI, submittal, and change-order data the connectors don't expose.
Supergood handles username/password and MFA in a managed, encrypted session with automatic refresh and credential rotation, so your integration stays connected without manual re-authentication.