API & Developer Reference
Build against HUM with the OpenAPI contract, the developer docs, and the embeddable widget.
Everything in HUM is API-first — the console uses the same endpoints you can.
The developer docs
The developer documentation covers authentication, the call lifecycle, agents, numbers, SMS, webhooks, and integration patterns, with example requests.
OpenAPI
A curated OpenAPI spec (JSON and YAML) describes the customer-facing API surface — use it for review, client generation, and integration planning. A read-only Swagger reference is hosted alongside it.
Authentication model
HUM is session-first: API requests use your BlueHive SSO session and are scoped to your organization membership. Server-to-server surfaces (webhook receivers, CRM connectors, inbound triggers) use signed secrets instead.
The embeddable widget
A drop-in widget lets you put an AI voice session on your own website, gated by per-widget keys, origin allowlists, and abuse protections — talk to us about enabling it for your account.