API reference
Capture a behavior event
Stores one behavior event for an account. Scoring is not triggered here; the scheduled recompute job remains the sole writer of health and inbox outcomes.
curl -X POST https://test.useatune.com/api/v1/events \ -H "Authorization: Bearer <YOUR_API_KEY>" \ -H "Content-Type: application/json" \ -d '{ "accountId": "acme", "userId": "user_123", "event": "feature.report.generated", "properties": { "reportType": "activation" } }'Sign in to find your API key in Settings.
POST
/api/v1/eventsStores one behavior event for an account. Scoring is not triggered here; the scheduled recompute job remains the sole writer of health and inbox outcomes.
Authorization
bearerAuth AuthorizationBearer <token>
Workspace API key from Atune settings or onboarding.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/api/v1/events" \ -H "Content-Type: application/json" \ -d '{ "accountId": "acme", "userId": "user_123", "event": "feature.report.generated", "properties": { "reportType": "activation", "source": "dashboard" }, "accountStage": "trial", "trialEndsAt": "2026-08-15T00:00:00.000Z", "accountPlan": "Pro", "accountSeats": 10, "accountMrr": 490, "accountCurrency": "NOK" }'{ "ok": true, "account": { "id": "cm123", "externalId": "acme" }, "user": { "id": "cm456", "externalId": "user_123" }}