Chatspark
K

API Reference

v1
K

ChatSpark Developer Documentation

Build powerful AI chat integrations with the ChatSpark REST API and embed the Chat Widget on your website. Get started in minutes.

REST API

Server-side integrations for chat, agents, conversations, leads, analytics, training, and webhooks.

5 min to first call

Chat Widget

Embed a conversational AI widget on your website. Customize appearance, capture leads, and subscribe to events.

2 min to embed

What you can build

  • Customer Support Bot
  • Lead Capture Widget
  • Slack Integration
  • WhatsApp Agent
  • E-commerce Assistant
  • Booking Agent

Quick Start

Send your first chat message in seconds. Replace cs_live_... with your API key and {id} with your agent ID.

bash

curl -X POST https://chatspark.io/api/v1/agents/{id}/chat \
  -H "Authorization: Bearer cs_live_..." \
  -H "Content-Type: application/json" \
  -d '{"message":"Hello!"}'

Read the full Quick Start guide →

Plan & Rate Limits

API access and rate limits vary by plan. Upgrade to unlock more endpoints and higher throughput.

PlanAPI AccessEndpointsRate Limit
BasicNo access
PlusChat, Conversations, LeadsChat, List agents, Conversations, Leads60 req/min
ProPlus + Agents, Analytics+ Agent CRUD, Analytics120 req/min
EnterpriseFull access+ Training, Webhooks, Full CRUD300 req/min

Ready to integrate?

Follow our Quick Start guide to make your first API call in under 5 minutes.