Skip to main content

HueChat API v2 Released

· One min read
HueChat Team
HueChat Team
HueChat Engineering

We're excited to announce the release of HueChat API v2!

What's New​

Simplified Authentication​

We've streamlined authentication to use API keys only. No more OAuth flows or JWT token management - just a simple API key in your request header.

curl https://api.huechat.ai/v2/contacts \
  -H "X-API-Key: sk_live_your_key"

New Endpoints​

  • Webhooks API - Register webhooks programmatically
  • Workflows API - Create automation workflows via API
  • Analytics API - Access your analytics data

Improved Rate Limits​

  • Free tier: 100 requests/minute
  • Pro tier: 1,000 requests/minute
  • Enterprise: Custom limits

Better Error Messages​

All error responses now include detailed information to help you debug issues quickly:

{
  "error": "invalid_input",
  "message": "Phone number must be in E.164 format",
  "code": 400,
  "details": {
    "field": "phone",
    "received": "1234567890",
    "expected": "+1234567890"
  },
  "request_id": "req_abc123"
}

Migration from v1​

If you're upgrading from v1, here are the key changes:

  1. Authentication: Use X-API-Key header instead of Authorization: Bearer
  2. Base URL: Changed from /api/v1 to /v2
  3. Response format: All responses now include request_id for debugging

Getting Started​

Ready to try the new API? Check out our quickstart guide to send your first message in 5 minutes.

Questions? Reach out to support@huechat.ai.