Contents
Guided setup
Integrations
Events API
Self hosting
Log limits and errors
Use this page as a quick pre-launch check.
Request basics
- Send
Authorization: Bearer <API_KEY>. - Send JSON to
POST /api/v1/log. - Include at least one of
nameorcontent.
Common responses
201: event accepted.400: payload or validation issue.401: bearer token missing or invalid.
Common issues
- Invalid
typevalue. contentis too large.- Action fields are missing (
url,buttonText, orkey).
Size limits
- JSON parser limit:
100kb. - Plain text parser limit:
10kb. - On MySQL event storage, string
contentmax is6000characters. - Otherwise server-side content check allows up to
100000characters.
Test mode
Use test: true if you want to test safely without mixing with normal feed views.
await ops.events.log({
name: "checkout webhook replay",
avatar: "🧪",
test: true,
content: "Replay run for webhook evt_123",
});