API Overview - SetterMaxer AI

Base URL

All API endpoints are served from your SetterMaxer instance:

https://app.settermaxer.com/api/v1

SetterMaxer has three types of API endpoints:

Type	Auth	Examples
Public	None	Widget API (`/widget/`), embed pages (`/embed/`)
Authenticated	Session cookie	Calendar OAuth, WhatsApp, billing endpoints
API key	`Authorization: Bearer smx_live_...`	Zapier endpoints (`/zapier/*`)

API keys are used for the Zapier integration and follow this format:

smx_live_a1b2c3d4e5f6...

Manage API keys at Organisation Settings → API Keys (admin/owner only, Standard/Pro plans).

Limit	Value
Max API keys per org	10
Key format	`smx_live_` + 32 hex characters

API keys are shown once at creation time and cannot be retrieved later. Store them securely.

Inbound webhooks from third-party services use signature verification:

The widget API enforces per-agent and per-session rate limits. See Widget API for details.

Public endpoints for the chat widget — init sessions, send messages, poll responses.

Configure outbound webhooks to receive events in your systems.

REST Hooks API for Zapier integration with API key auth.