Skip to main content
HubSpot’s conversations tools let you embed live chat in your website or mobile app, and programmatically read and manage inbox data. Depending on your use case, you can work with a client-side SDK or a REST API.

SDKs

The SDKs provide client-side control over the live chat experience. They don’t require REST API calls. Instead, you load the SDK in your app and interact with the chat widget or mobile chat interface directly.
  • Chat widget SDK: customize and control the HubSpot live chat widget on your website. Use this to open or close the widget, identify visitors, listen for events, and more.
  • Android mobile SDK: embed HubSpot live chat into your Android app.
  • iOS mobile SDK: embed HubSpot live chat into your iOS app.

REST APIs

The conversations REST APIs let you read and manage inbox data: inboxes, channels, threads, messages, and actors.

Beta API (2026-09)

The 2026-09-beta conversations API is the current recommended version for new integrations. It includes endpoints for actors, channel accounts, channels, inboxes, messages, and threads.

Latest API (2026-03)

The latest conversations API includes endpoints for integrating custom messaging channels and identifying authenticated visitors:
  • Custom channels: integrate your own messaging channels into the HubSpot inbox. Includes endpoints for managing channels, channel accounts, and messages.
  • Visitor identification: generate tokens to identify authenticated visitors in the chat widget.

Legacy API

The legacy conversations API is the previous version of the REST API.
Last modified on March 30, 2026