Developers and API overview

Use the developer guides when you need to connect Hellotext with your own site, backend, CRM, commerce platform, or internal tools.

If you are connecting a custom store without a native integration, start with Integrate a custom store with Hellotext. It puts profiles, properties, products, historical orders, Hellotext.js, identity, and server-side tracking in the correct implementation order.

Most developer work in Hellotext falls into six areas:

  • Integrating a custom store from end to end.
  • Reading the API reference.
  • Sending messages from your own system.
  • Tracking customer activity.
  • Defining business-specific actions and objects.
  • Connecting unidentified sessions to customer profiles.

Custom store integration

The custom-store guide is the practical starting point for a team that does not yet know which data belongs in the API, which activity belongs in Hellotext.js, or how the two sides connect.

Start here: Integrate a custom store with Hellotext.

API reference

The API reference is the source of truth for available resources, attributes, parameters, and endpoints.

Open the Hellotext API reference.

Authentication

API requests use bearer tokens.

Create an authorization token from your business settings, then send it in the Authorization header:

Authorization: Bearer YOUR_TOKEN

Never expose private tokens in browser code, public repositories, or client-side scripts.

Send SMS from your system

Use the messages API when your own system needs to send reminders, confirmations, or notifications by SMS.

Keep reading: Send SMS with the API.

Track customer activity

Use tracking when you want Hellotext to understand actions from your site, store, backend, or custom integration.

Tracked events can help you segment audiences, trigger playbooks or routes, attribute revenue, and give the inbox team more context.

Keep reading: Tracking events.

Model business-specific activity

Use custom actions to name activity that Hellotext does not include by default. Use objects when that activity involves a reusable entity with its own properties and lifecycle.

Keep reading: Custom actions and Objects.

Connect browser sessions to customer profiles

Hellotext.js can create a session for unidentified visitors. When the visitor becomes known, you can attach that session to a customer profile so earlier activity is preserved.

Keep reading: Tracking unidentified customers.