Atune Docs
API reference

Ingest Segment messages

Accepts Segment-style `track`, `identify`, `group`, or batch payloads. Segment is a compatibility ingress path; after mapping, messages use the same internal ingest core as native Atune capture.

Send a Segment track
curl -X POST https://useatune.com/api/segment \  -H "Authorization: Bearer <YOUR_API_KEY>" \  -H "Content-Type: application/json" \  -d '{    "type": "track",    "messageId": "seg-msg-001",    "event": "Invoice Sent",    "userId": "user_123",    "properties": {      "accountId": "acme",      "amount": 1200    }  }'

Sign in to see this sample with your own workspace API key.

POST/api/segment

Accepts Segment-style track, identify, group, or batch payloads. Segment is a compatibility ingress path; after mapping, messages use the same internal ingest core as native Atune capture.

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

application/json

curl -X POST "https://example.com/api/segment" \  -H "Content-Type: application/json" \  -d '{    "type": "track",    "messageId": "seg-msg-001",    "event": "Invoice Sent",    "userId": "user_123",    "properties": {      "accountId": "acme",      "amount": 1200    }  }'

{  "ok": true,  "deduped": true,  "source": "segment",  "account": {    "id": "cm123",    "externalId": "acme"  },  "user": null}

Attach intentional identity traits POST

The only public API path that accepts PII. It writes company, name, and email traits only after the workspace has accepted the DPA.

Ask a grounded question POST

Answers a question about an account, user, feature, or portfolio from the workspace's existing signals. The endpoint returns `knows: false` instead of guessing when the bundle does not support an answer.