17hats API
17hats is an all-in-one CRM and small business management platform for service-based businesses, consolidating client management, quotes, contracts, invoices, scheduling, payments, and workflow automation in one application. With no public REST API, an unofficial API lets you programmatically pull contacts, documents, invoices, payments, projects, and workflows—and push updates like new leads, quotes, and payment records back into 17hats.
What is 17hats?
17hats is a cloud-based CRM and small business management platform built for service-based businesses—photographers, coaches, designers, and similar solo and small-team operators. It consolidates client management, sales pipelines, quotes, contracts, invoices, online scheduling, payments, and workflow automation into a single application built in-house, so owners run their entire client lifecycle from lead capture to payment in one place.
Core product areas include:
- Client Management (contacts, client portals, lead questionnaires, and vetting)
- Sales Pipeline (visual pipeline management with customizable stages)
- Documents (quotes, contracts, and invoices combined into unified documents)
- Scheduling (online booking with Zoom integration and group bookings)
- Financial (invoicing with auto-pay, bookkeeping, and payment tracking)
- Automation (workflow triggers for email, document delivery, and task creation)
- Payments (online processing via Stripe plus manual payment tracking)
Common data entities:
- Contacts, Clients, Leads, Client Portal accounts
- Quotes, Contracts, Invoices, Documents
- Projects, Pipelines, Lead Stages
- Payments, Auto-pay schedules, Bookkeeping entries
- Workflows, Automations, Tasks
- Bookings, Schedules, Questionnaires
The 17hats Integration Challenge
Service-based businesses run their entire client lifecycle in 17hats, but getting that data out programmatically is hard—17hats exposes no public REST API, so the operator's own contacts, documents, and payment history stay trapped behind the web app:
- No public API: 17hats publishes no developer API or documentation—third-party connectivity is limited to Zapier and a small set of native integrations
- Zapier-only automation: Trigger-and-action recipes cover common events but cannot read full document, invoice, or contact history on demand
- Unified documents: Quotes, contracts, and invoices are combined into single documents, so extracting line items, signatures, and payment state requires careful parsing
- Web-app-only access: Client records, pipelines, and bookkeeping live behind an authenticated browser session with no headless data export
- Payment reconciliation: Stripe payments, auto-pay schedules, and manual entries must be tied back to the originating invoice and client for accounting sync
- Workflow state: Automation triggers and task progression are internal to 17hats and not externally observable without polling the UI
How Supergood Creates 17hats APIs
Supergood reverse-engineers the authenticated 17hats web application to deliver a resilient API layer for your account—so you can read and write contacts, documents, invoices, payments, and workflows without a public API existing.
- Handles email/password and two-factor authentication securely in a managed session
- Maintains session continuity with automated refresh and change detection
- Normalizes responses across Contacts, Documents, Invoices, Payments, and Workflows so you integrate once and rely on consistent objects
- Reconciles Stripe payments and auto-pay activity back to the originating invoice and client record
Use 17hats with AI agents: 17hats MCP Server →
Getting Started
- Schedule Integration Assessment
Book a 30-minute session to confirm your modules, data entities, and authentication model.
- Supergood Generates and Validates Your API
We deliver a production-ready 17hats API tailored to your account configuration and data.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adjustments as 17hats evolves.
API Endpoints
Authentication
/authenticateAuthenticate to a 17hats account using email/password and two-factor authentication, and obtain a session token for downstream calls.
Contacts
/contactsList contacts and clients with filters for pipeline stage, lead status, and tags.
Contacts
/create_contactCreate a new lead or client record and place it into a pipeline stage.
Documents
/documentsRetrieve quotes, contracts, and invoices with line items, signature status, and payment state.
Invoices
/create_invoiceGenerate an invoice or quote for a client with line items and auto-pay configuration.
Payments
/paymentsPull payment records, auto-pay schedules, and bookkeeping entries reconciled to invoices and clients.
Use Cases
Sync client and document data into your warehouse
- Pull contacts, leads, and pipeline stages from 17hats into a single CRM or data warehouse - Extract quotes, contracts, and invoices with line items and signature status - Reconcile client records across 17hats and downstream marketing tools
Automate invoicing and payment reconciliation
- Push new invoices and quotes into 17hats from your booking or proposal tools - Sync Stripe payments and auto-pay activity into accounting and general ledger systems - Match payments and bookkeeping entries back to the originating invoice and client
Drive lead capture and pipeline automation
- Create leads and contacts in 17hats from external forms and ad platforms - Advance pipeline stages and trigger workflow automations programmatically - Surface lead questionnaire responses to downstream qualification tools
Power reporting and client 360 dashboards
- Aggregate revenue, outstanding invoices, and payment history for business reporting - Combine bookings, projects, and document activity into a unified client view - Feed task and workflow state into operational dashboards
Technical Specifications
Authentication
Email/password and two-factor authentication handled in a managed session
Connectivity
Authenticated browser flows against the 17hats web application, since no public API is published
Response format
Normalized JSON across Contacts, Documents, Invoices, Payments, and Workflows objects
Rate limits
Adaptive throttling tuned to your account to avoid 17hats-side limits
Session management
Automatic session refresh, two-factor replay handling, and credential rotation
Data freshness
Near real-time pulls for contacts, documents, and payments 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 leads, document signatures, invoice payment, and workflow triggers
Latency
Sub-second reads on cached entities; multi-second writes when posting documents and invoices
Throughput
Horizontally scaled workers sized to your account's contact, document, and payment volume
Reliability
Retry, backoff, and idempotency keys for invoice creation and payment reconciliation
Adaptation
Continuous monitoring of 17hats web application changes and configuration drift
Frequently asked questions
No. 17hats does not publish a developer REST API or documentation—native connectivity is limited to Zapier and a small set of integrations. Supergood provides a programmatic API by working against your authenticated 17hats account, so you can read and write contacts, documents, invoices, and payments directly.
Yes. 17hats combines quotes, contracts, and invoices into unified documents. Supergood parses these into normalized objects with line items, signature status, and payment state so you can sync them into accounting and CRM systems.
Supergood ties Stripe payments, auto-pay schedules, and manual payment entries back to the originating invoice and client record, so your accounting and reporting systems receive fully reconciled transactions.
Yes. Zapier covers trigger-and-action recipes for common events but cannot read full contact, document, or payment history on demand. The Supergood API exposes complete read and write access across your 17hats data entities.
Each account is profiled against its configured pipelines, document templates, and workflows. Supergood continuously monitors the 17hats web application and adapts to UI and configuration changes without breaking your integration.