Skip to Content
JourneyKit
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.

EndpointWho calls it
POST /api/ingest/trackYour frontend (via the SDK) and backend
POST /api/ingest/identifyYour frontend (via the SDK) and backend

Authentication

Send a workspace API key as a bearer token:

Authorization: Bearer jk_live_…
KeyPrefixUseRestrictions
Publicjk_pub_Browser SDKCannot set timestamp on events
Secretjk_live_Your serversNone, 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

StatusBodyWhen
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.

On this page