HoneyBook API
HoneyBook is an AI-powered client relationship platform that helps small service businesses manage clients, projects, and payments from lead to completion—covering CRM, proposals, contracts, invoicing, online payments, scheduling, and automations. An unofficial API lets you programmatically pull clients, projects, invoices, payments, contracts, and leads—and push updates like new inquiries, invoices, and scheduled meetings back into HoneyBook.
What is HoneyBook?
HoneyBook is an AI-powered client relationship platform that helps small business owners manage clients, projects, and payments from lead to completion. Service-based businesses—photographers, event planners, designers, consultants, coaches, and other creative and professional service providers—use HoneyBook to capture leads, send proposals and contracts, invoice and collect payments, schedule meetings, and automate routine client communications across a single pipeline.
Core product areas include:
- CRM and client management with a lead-to-completion project pipeline
- Proposals, contracts, and online signatures
- Invoicing and online payments
- Meeting scheduling and calendar integration
- Lead capture forms, contact forms, and questionnaires
- Client portal, task management, automations, and workflow tools
- HoneyBook AI (email drafts, project recaps, meeting notes, business insights)
Common data entities:
- Clients, Contacts, and Leads/Inquiries
- Projects, Pipeline Stages, and Tasks
- Proposals, Contracts, and Signatures
- Invoices, Payments, and Payment Schedules
- Meetings, Sessions, and Calendar Events
- Forms, Questionnaires, Files, and Automations
The HoneyBook Integration Challenge
Small businesses run their entire client lifecycle on HoneyBook, but turning that portal-driven workflow into API-driven automation is non-trivial:
- No public developer program: HoneyBook does not offer open, self-serve API access or published REST documentation for third-party developers
- Integration is gated through partners: most connections flow through Zapier or a handful of pre-built integrations (QuickBooks, Gmail, Calendly, Zoom) rather than a general-purpose API
- Authentication complexity: account login plus optional MFA complicates headless, server-to-server automation
- Spread across modules: clients, projects, invoices, contracts, and scheduling each have their own object models, IDs, and lifecycle states
- Payment and contract workflows: invoices, payment schedules, and signed contracts require careful status and reason-code handling for downstream accounting
- Automation side effects: triggering workflows, emails, and reminders without double-firing existing HoneyBook automations requires precise control
How Supergood Creates HoneyBook APIs
Supergood reverse-engineers authenticated browser flows and HoneyBook's underlying client, project, and payment interactions to deliver a resilient API layer for your HoneyBook account—without waiting on a public developer program.
- Handles account login and MFA (SMS, email, TOTP) securely
- Maintains session continuity with automated refresh and change detection
- Normalizes responses across clients, projects, invoices, payments, and contracts so you integrate once and rely on consistent objects
- Respects existing automations and pipeline stages to avoid duplicate emails or workflow triggers
Use HoneyBook with AI agents: HoneyBook MCP Server →
Getting Started
- Schedule Integration Assessment
Book a 30-minute session to confirm your HoneyBook workflows, entities, and authentication model.
- Supergood Generates and Validates Your API
We deliver a production-ready HoneyBook adapter tailored to your account, clients, and payment workflows.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adjustments as HoneyBook evolves.
API Endpoints
Authentication
/authenticateAuthenticate to a HoneyBook account using credentials, or MFA, and obtain a session token for downstream calls.
Clients
/clientsList clients and contacts with filters for status, project association, and creation date range.
Projects
/projectsRetrieve projects across the pipeline with filters for stage, client, value, and date range.
Projects
/create_inquiryCreate a new lead or inquiry and start a project in the configured pipeline stage.
Billing
/invoicesPull invoices, payment schedules, and payment activity with status and project filters.
Billing
/create_invoiceCreate and send an invoice against a project with line items and a payment schedule.
Use Cases
Sync clients and projects into your CRM or warehouse
- Pull clients, contacts, and leads from HoneyBook into a single warehouse - Stream project pipeline stage changes to downstream BI and reporting tools - Reconcile contact records across HoneyBook and your marketing stack for a unified view
Automate invoicing and payment reconciliation
- Sync invoices, payment schedules, and payments into your general ledger and AR systems - Match payments against projects and contracts for accurate revenue recognition - Surface overdue invoices and failed payments to retention and collections workflows
Push new inquiries and bookings into HoneyBook
- Create leads and inquiries from your website forms or ad platforms without manual entry - Start projects in the correct pipeline stage and assign owners automatically - Trigger HoneyBook proposals and contracts from upstream booking systems
Keep scheduling and contracts in sync
- Pull scheduled meetings and sessions into external calendars and ops tools - Track contract and signature status for compliance and onboarding workflows - Sync signed contracts and files to document management and accounting systems
Technical Specifications
Authentication
Account credentials and MFA (SMS, email, TOTP) handled in a managed session
Connectivity
Authenticated browser flows plus HoneyBook's underlying client, project, and payment interactions
Response format
Normalized JSON across Clients, Projects, Invoices, Payments, and Contracts objects
Rate limits
Adaptive throttling tuned to your account to avoid HoneyBook-side limits
Session management
Automatic session refresh, MFA replay handling, and credential rotation
Data freshness
Near real-time pulls for clients, projects, invoices, 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 inquiries, project stage changes, invoice payments, and contract signatures
Latency
Sub-second reads on cached entities; multi-second writes when posting through invoicing and inquiry workflows
Throughput
Horizontally scaled workers sized to high-volume client and payment activity
Reliability
Retry, backoff, and idempotency keys for invoice creation, payments, and inquiry submissions
Adaptation
Continuous monitoring of HoneyBook releases and UI changes to keep the integration stable
Frequently asked questions
HoneyBook does not offer an open, self-serve developer program or published REST documentation for third-party developers; most integrations flow through Zapier or a handful of pre-built connections. Supergood provides a resilient API layer over your authenticated HoneyBook account so you can integrate directly.
Clients, contacts, leads, projects, pipeline stages, proposals, contracts, invoices, payments, scheduled meetings, forms, and files are all exposed through a normalized API surface, with both read and write access.
No. Supergood respects your existing pipeline stages and automation triggers, so programmatic writes won't double-fire emails, reminders, or workflows you've already configured.
Supergood handles account login and MFA (SMS, email, TOTP) inside a managed, encrypted session, with automatic refresh and credential rotation—no manual re-authentication required for ongoing automation.
Yes. Invoices, payment schedules, and payments are normalized so you can reconcile them against projects and contracts and push them into your general ledger, AR, or QuickBooks workflows.