Customer identity

Create and update customer profiles

Identify customers

TL;DR: POST /v1/customers/identify with an immutable externalId. Don't use email as the primary key.

curl -X POST https://app.tryjake.ai/v1/customers/identify \
  -H "Authorization: Bearer <application credential>" \
  -H "Content-Type: application/json" \
  -d '{
    "externalId": "user_123",
    "email": "alice@example.com",
    "displayName": "Alice Smith",
    "attributes": { "plan": "pro", "locale": "en-IE" }
  }'

Other ways to populate profiles

Segment — Extensible Webhooks destination
Intercom — OAuth imports contacts automatically
SDK sessions — bind on session creation

Don't send secrets or sensitive data as traits.

API overview

Customer identity, SDK sessions, and support adapter endpoints

Customer channels

Where customers reach Jake — web, iOS, Android, React Native, or API

On this page

Identify customers Other ways to populate profiles