Quickstart

Get a token

Sign in to app.huechat.ai, open Settings → Profile and copy your Access token. It carries your full role, which is fine for a first call. For anything that ships, create a scoped API key instead.

Find your account id

It is the number in the dashboard URL: https://app.huechat.ai/app/accounts/{account_id}/.... Every route below takes it in the path.

List conversations

curl https://app.huechat.ai/core/accounts/$ACCOUNT_ID/conversations \
  -H "Authorization: Bearer $HUECHAT_TOKEN"

200 with a payload array means the token works. Keep a conversation_id from the response for the next step.

Send a message

curl -X POST https://app.huechat.ai/core/accounts/$ACCOUNT_ID/conversations/$CONVERSATION_ID/messages \
  -H "Authorization: Bearer $HUECHAT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"content": "Hello from the API", "message_type": "outgoing"}'

The message goes out on whichever channel the conversation lives on: WhatsApp, Instagram, Messenger, email or live chat.

Create a contact

curl -X POST https://app.huechat.ai/core/accounts/$ACCOUNT_ID/contacts \
  -H "Authorization: Bearer $HUECHAT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "Mohammed Ali", "phone_number": "+966501234567", "email": "mohammed@example.com"}'

These calls hit your live account. A POST from this page sends a real message to a real customer. Try writes against a test conversation first.

Where next

Authentication for how the two credentials differ.
Webhooks to get events pushed to you instead of polling.
API reference for every endpoint with a runnable panel.

Get started

Working with the API

Integrate

Where next

​Where next

Where next