4 Native Integrations · 6 Toolkit Scripts

Connect ESXPress to Your Stack

Every integration on this page is verified against the ESXPress codebase — real endpoints, real payloads, real limits. No vaporware.

Native Integrations

Built into the ESXPress backend — every endpoint below is verified in app/api/v1/. Active and working right now.

🔔✅ Live

ESXPress Webhooks

HTTP POST · Configurable · HTTPS only

Fire conversion-complete payloads to any HTTPS URL. Configure via POST /api/v1/webhooks/configure with an optional HMAC secret. 3 retries (5s/15s/45s backoff), delivery status tracked per webhook. Enterprise plan (or the $49/mo API & Integrations add-on).

🔌✅ Live

ESXPress REST API

API Key · 60 req/min · OpenAPI docs

Upload PDFs, poll conversion status, download ESX files — all programmatically. Auth via X-API-Key header or Bearer token. Keys are created in Dashboard → Settings → API Keys and shown exactly once. Docs at /api/v1/docs.

💬✅ Live

Slack Bot

Slash Command · /esxpress

Type /esxpress upload <pdf-url> in Slack to convert a scope from a public PDF URL, /esxpress status <id> to check progress, /esxpress list for recent jobs. HMAC-verified requests, Block Kit responses. Workspace linking is managed by ESXPress.

💳✅ Live

Stripe Billing

Subscriptions · Checkout · Portal

Payment backbone: /api/v1/billing/create-checkout, /prices, /webhook, /status, /portal. Signature-verified inbound webhook receiver at /api/v1/billing/webhook upgrades tenants on checkout.session.completed.

Integration Toolkit — Shipped Scripts

Standalone, repo-shipped connectors in scripts/integrations/ that push ESX files into each platform's public API. Bring your own credentials — these are NOT in-app native connectors.

🦅🧰 Toolkit

AccuLynx Connector

Script · REST v1 · Bearer / X-API-Key

acculynx_connector.py — list jobs and upload the generated ESX file as a job document via api.acculynx.com/v1. Run it after conversion; pair with a webhook to automate the trigger.

📸🧰 Toolkit

CompanyCam Connector

Script · REST v2 · Token

companycam_connector.py — list projects, create projects, and upload photos to api.companycam.com/v2. Requires a CompanyCam Pro/Premium/Elite plan for API access.

📊🧰 Toolkit

QuickBooks Online Connector

Script · OAuth 2.0

quickbooks_connector.py — OAuth 2.0 attachment upload to invoices/estimates in QuickBooks Online via quickbooks.api.intuit.com/v3.

⚡🧰 Toolkit

Zapier

Template · Catch Hook

zapier_template.json ships the payload schema and step-by-step Catch Hook setup. Point a webhook at your hooks.zapier.com URL and ESXPress fires conversion.completed into any Zap.

API Docs ↗

🔔🧰 Toolkit

Universal Webhook Receiver

Python stdlib · Zero dependencies

universal_webhook_receiver.py — drop-in HTTP server that receives webhook payloads, logs them to JSON, and can forward to another endpoint (e.g. a Zapier hook). Ideal test endpoint or relay.

📘🧰 Toolkit

Integration Guide

README · 8 platforms

scripts/integrations/README.md — platform comparison matrix, environment variables, connector usage, troubleshooting, and platform-specific notes for HubSpot, Salesforce, EagleView, and JobNimbus.

Via Webhook — No Native Connector

These platforms have public APIs but no ESXPress connector ships in the app. Connect them the universal way: configure a webhook, then route conversion.completed payloads into the platform — via Zapier, the shipped receiver script, or your own middleware.

🌐🌐 Via Webhook

HubSpot · Salesforce · EagleView · JobNimbus

Via Webhook + Integration Guide

HubSpot Private Apps (files/v3), Salesforce Attachment/ContentVersion objects, EagleView's developer portal, and JobNimbus's customer-gated API are all documented in the integration guide. No in-app connector exists — the webhook delivers the payload, you route it.

💎 Add-on

API & Integrations Add-on — $49/mo

$49/mo add-on on Starter & Professional · Included with Enterprise & Volume

View Pricing API Keys

What you get

🔑 API keys — create / list / revoke (/api/v1/keys), full key shown once, esx_… format, SHA-256 hashed at rest
🔌 Public REST API — upload, status, download endpoints with key auth
🔔 Outbound webhooks — unlimited URLs, HMAC signing, 3× retry, delivery status
📖 /api/v1/docs — styled API docs + FastAPI OpenAPI (/docs)

Limits (verified in code)

⏱️ 60 requests / minute / API key — over the limit returns HTTP 429
📄 50 MB max per PDF upload
🔒 HTTPS-only webhook targets (SSRF-guarded, PII-safe)
🔄 3 attempts per webhook delivery (5s / 15s / 45s backoff; 4xx not retried)
🚦 Feature gates: api_keys + webhooks require the enterprise tier in app/core/plan_gating.py

How it bills: checkout runs through Stripe with the api_addon price (STRIPE_PRICE_API_ADDON_MONTHLY). Enterprise and Volume plans include API access and webhooks with no add-on.

Step-by-Step Guides

1 · Connect via Webhook

Fire conversion.completed payloads to any HTTPS endpoint — your server, Zapier, Make, n8n, or the shipped receiver script.

1Make sure API & Integrations is active on your plan (Enterprise — or the $49/mo add-on on Starter / Professional).
2Get an HTTPS endpoint: create a Zapier Webhooks → Catch Hook trigger (URL looks like https://hooks.zapier.com/hooks/catch/…), spin up the shipped receiver (python universal_webhook_receiver.py --port 8080), or point at your own service.
3Register the URL via POST /api/v1/webhooks/configure. Note: webhook configuration is authenticated with your account session/JWT, while the payload is delivered to your endpoint unauthenticated but optionally HMAC-signed.
4Convert any PDF. When the conversion reaches ready, every active webhook is POSTed the payload below (up to 3 attempts, 15s timeout each).
5Verify delivery in GET /api/v1/webhooks — each webhook reports last_fired_at, last_status_code, and last_error.

# Configure a webhook (Enterprise plan / API add-on required)
curl -X POST https://esxpress.org/api/v1/webhooks/configure \
  -H "Authorization: Bearer <your-jwt>" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://hooks.zapier.com/hooks/catch/123456/abcdef/",
    "secret": "your-hmac-secret",
    "is_active": true
  }'

# Manage: GET /api/v1/webhooks · PATCH /api/v1/webhooks/{id} · DELETE /api/v1/webhooks/{id}
# HTTPS only — cleartext http:// is rejected (payloads contain PII).
# When a secret is set, every delivery carries:
#   X-Webhook-Signature: sha256=<hmac-hex>
#   X-Webhook-Timestamp: <unix-epoch>
#   X-Webhook-Signature-Version: v1

Payload delivered on every conversion (event: conversion.completed)

{
  "event": "conversion.completed",
  "tenant_id": 1,
  "tenant_name": "Acme Roofing",
  "tenant_slug": "acme",
  "conversion_id": 42,
  "filename": "scope.pdf",
  "esx_filename": "42_VERIFIED.esx",
  "esx_download_url": "https://esxpress.org/api/v1/public/convert/42/download",
  "esx_ready": true,
  "status": "ready",
  "total_line_items": 24,
  "total_rcv": 15234.56,
  "carrier_name": "StateFarm",
  "claim_number": "22-ABC-1234",
  "insured_name": "John Doe",
  "property_address": "123 Main St",
  "timestamp": "2026-08-07T01:32:00Z",
  "source": "esxpress"
}

Signed delivery: when you set a secret, receivers can verify X-Webhook-Signature: sha256=… over the raw body with X-Webhook-Timestamp(reject |now − ts| > 300s for anti-replay). Event headers also include X-ESXPress-Event, X-ESXPress-Conversion-ID, and X-ESXPress-Tenant-ID.

2 · Use the API

Base URL https://esxpress.org/api/v1/public · Auth via X-API-Key header or Authorization: Bearer

1Create a key: Dashboard → Settings → API Keys (or POST /api/v1/keys). The full key is shown exactly once — save it. Keys are scoped to your tenant and revocable anytime.
2Upload one or more PDFs (≤50MB each, batch supported). Each valid file is queued immediately; invalid files are reported in errors without aborting the batch.
3Poll status until "ready" — the response includes the extracted line items, totals, claim number, and carrier.
4Download the validated .esxfile (import validation checked before every serve). If the file went stale (>24h), it is auto-regenerated from stored line items.

End-to-end with curl

# Upload a PDF (multipart; up to 50MB per file, batch supported)
curl -X POST https://esxpress.org/api/v1/public/convert/upload \
  -H "X-API-Key: esx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -F "[email protected]" \
  -F "carrier=StateFarm"

# → { "ok": true, "jobs": [ { "filename": "scope.pdf", "task_id": "...", "conversion_id": 42 } ], ... }

# Poll status until "ready"
curl -H "X-API-Key: esx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  https://esxpress.org/api/v1/public/convert/42/status

# Download the ESX file
curl -OJ -H "X-API-Key: esx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  https://esxpress.org/api/v1/public/convert/42/download

Errors: 401 missing/invalid/revoked key · 400 not a PDF / too large · 404 conversion not found · 409 ESX failed validation · 410 stale file, re-upload · 429 rate limit (60 req/min/key). Full docs: /api/v1/docs — OpenAPI at /docs.

3 · Slack Bot

Endpoint POST /api/v1/slack/command — receives the /esxpress slash command, HMAC-SHA256 verified (5-minute timestamp window), workspace → tenant mapping maintained by ESXPress. Conversions run async; responses are Slack Block Kit.

Commands

Commands                     What it does
──────────────────────────────────────────────────────────────
/esxpress upload <pdf-url>    Convert a scope from a PUBLIC PDF URL
                              (optional: carrier:StateFarm)
/esxpress status <job-id>     Check conversion status
/esxpress list [N]            List recent conversions (default 5)
/esxpress help                Show usage guide

1Install the ESXPress Slack app in your workspace (or ask ESXPress support to link your workspace — linking is admin-managed via POST /api/v1/slack/link).
2Run /esxpress upload https://…/scope.pdf carrier:StateFarm in any channel. The bot downloads the PDF (public URL only, ≤25MB, SSRF-guarded), queues the conversion, and confirms with the job ID.
3Track it with /esxpress status 42, or browse recent jobs with /esxpress list. /esxpress help shows the guide inline.

Note: uploads are URL-based, not file drops — the bot fetches a public PDF link you paste. There is no Microsoft Teams connector in the codebase.

🔍

Verified — nothing on this page is aspirational

AccuLynx, CompanyCam, QuickBooks, Zapier, and the universal receiver ship as standalone scripts under scripts/integrations/. HubSpot, Salesforce, EagleView, and JobNimbus are covered by the integration guide and connect via webhooks — no native connector ships. There are no native connectors for any third-party CRM or accounting platform inside the app itself, and no Teams/Procore/ BuilderTrend/Xactimate Cloud connectors exist.

Ready to Integrate?

Get your API key, configure a webhook, or connect Slack — in minutes.

Get Your API Key API Docs Request a Connector