API Documentation

Authentication

All API requests require a Bearer API key in the Authorization header. Generate API keys from your dashboard under Settings → API Keys.

API keys are prefixed with sk_ and can be scoped to specific permissions (read, write, leads:read, conversations:read, messages:write).

Base URL

All endpoints are prefixed with /v1/public/. Responses are JSON. Errors follow { message, statusCode } shape.

Endpoints

Code Examples

Quick-start examples in your language of choice.

// List conversations
const res = await fetch('https://api.saaschat.io/v1/public/conversations', {
  headers: { 'Authorization': 'Bearer sk_your_api_key' },
});
const { items, meta } = await res.json();

// Send a message
await fetch('https://api.saaschat.io/v1/public/conversations/conv_id/messages', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer sk_your_api_key',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ content: 'Hello!', senderType: 'bot' }),
});

Rate Limits

Rate limits apply per API key. Exceeding limits returns 429 Too Many Requests.

Changelog