> ## Documentation Index
> Fetch the complete documentation index at: https://developers.huechat.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> List your conversations, send a message, create a contact.

<Steps>
  <Step title="Get a token">
    Sign in to [app.huechat.ai](https://app.huechat.ai/app/login), 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](/api-keys) instead.
  </Step>

  <Step title="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.
  </Step>

  <Step title="List conversations">
    ```bash theme={null}
    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.
  </Step>

  <Step title="Send a message">
    ```bash theme={null}
    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.
  </Step>

  <Step title="Create a contact">
    ```bash theme={null}
    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"}'
    ```
  </Step>
</Steps>

<Warning>
  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.
</Warning>

## Where next

* [Authentication](/authentication) for how the two credentials differ.
* [Webhooks](/webhooks) to get events pushed to you instead of polling.
* [API reference](/api-reference/overview) for every endpoint with a runnable
  panel.