IntegrationIngest API
Ingest API
Base URL: https://journeykit.io. All endpoints live under /api/ingest/ and accept and return JSON. CORS is open, so the browser SDK can call them from any origin.
| Endpoint | Who calls it |
|---|---|
POST /api/ingest/track | Your frontend (via the SDK) and backend |
POST /api/ingest/identify | Your frontend (via the SDK) and backend |
Authentication
Send a workspace API key as a bearer token:
Authorization: Bearer jk_live_…| Key | Prefix | Use | Restrictions |
|---|---|---|---|
| Public | jk_pub_ | Browser SDK | Cannot set timestamp on events |
| Secret | jk_live_ | Your servers | None, keep it out of the browser |
Create keys under Settings → API keys. A key is shown in full only once. Each request bumps the key's last used and request count so you can see which keys are live.
Errors
| Status | Body | When |
|---|---|---|
400 | { "error": "Body must be JSON" } | Unparseable body |
400 | { "error": "Invalid payload", "issues": [ … ] } | Failed validation; issues lists each field |
401 | { "error": "Invalid or missing API key" } | No key, unknown key, or revoked |
403 | { "error": "Public keys cannot set event timestamps" } | |
404 | { "error": "Not found" } | Unknown path |
There is no rate limit today; batch events where you can.