Customers

Features

• check**Deterministic identity resolution** — profiles keyed on `(orgId, projectId, externalId)`. SDK `identify(userId, traits)` upserts on externalId. **Honest about scope:** no probabilistic cross-device fingerprint stitching today — externalId match only.
• check**Nested AND/OR audience builder** — groups of conditions on event types + properties + profile traits. No SQL, no warehouse round-trip. Evaluated at query time so membership is real-time.
• check**Audience size estimation** — `GET /audiences/:id` returns `estimatedSize` so you see how big a segment is before you target it.
• check**Arbitrary trait storage** — set any trait via `identify(userId, { ltv: 234, plan: "pro" })` and audience conditions can filter on it. **Honest:** there's no built-in computed-trait engine that calculates `first_seen` / `ltv` / `signin_count` for you — you write the value, we store it.
• check**AI lifecycle classifier** (opt-in via `ai_lifecycle_classifier_enabled`) — nightly cron classifies each profile into `new` / `active` / `at_risk` / `churned` based on event activity. Use as an audience condition.
• check**Anonymous → identified device-takeover** — anon `user_id` retired on signin, push tokens reassigned. No duplicate notifications. Webhook + inline SDK listener for your own mirror tables.
• check**Every module reads this** — Push uses audiences for targeting, Email uses them for segments, Automation uses them as triggers, In-App uses them for visibility, Surveys uses them for audience-trigger config. One identity, multiple surfaces.

Common use cases

• eastReplace Segment + mParticle + Customer.io CDP — already the source of truth, no reverse-ETL.
• eastB2B + B2C apps that need real-time audience membership in messaging + auth + support, not nightly warehouse syncs.
• eastMulti-device consumer products where the SAME externalId is passed via `identify()` across web + iOS + Android — those resolve to one profile. (For probabilistic cross-device match without a shared `externalId`, you'd still need a third-party identity-stitching vendor.)

Key concepts

Trait

Top-level user property — `email`, `plan`, `country`. Updatable via `identify({ traits })` or `update_profile` workflow step.

Audience

Saved query: `event-did-happen × event-didn't-happen × trait-is`. Powers segmentation across Email / Push / SMS / Workflow.

Lifecycle stage

AI-classified or rules-based (new / active / dormant / churned). Toggle per-org.

Profile traits

await sendora.identify({
  userId: "u_abc123",
  email: "alice@example.com",
  traits: { plan: "growth", company: "Acme" },
});

curl https://api.sendoracloud.com/api/v1/orgs/<ORG_UUID>/profiles/<PROFILE_UUID> \
  -H "x-api-key: pk_prod_…"

curl -X POST https://api.sendoracloud.com/api/v1/orgs/<ORG_UUID>/audiences \
  -H "x-api-key: pk_prod_…" \
  -d '{
    "name": "Active Pro users",
    "rules": { "all": [
      { "trait": "plan", "op": "eq", "value": "pro" },
      { "event": "feature_used", "op": "occurred_in_last", "value": "30d" }
    ]}
  }'

# Profile data export — uses Data-IO module (per-profile + bulk)
curl -X POST https://api.sendoracloud.com/api/v1/orgs/<ORG_UUID>/data-io/export \
  -H "x-api-key: pk_prod_…" \
  -d '{ "module": "profiles", "filter": { "profileId": "<PROFILE_UUID>" } }'

# Right-to-be-forgotten — cascade delete via consent module deletion-request
curl -X POST https://api.sendoracloud.com/api/v1/consent/deletion-request \
  -H "x-api-key: pk_prod_…" \
  -d '{ "userId": "u_abc123", "scope": "all" }'

# Direct profile delete (admin scope)
curl -X DELETE https://api.sendoracloud.com/api/v1/orgs/<ORG_UUID>/profiles/<PROFILE_UUID> \
  -H "x-api-key: pk_prod_…"

Audiences (segments)

// SERVER-SIDE only. The Web SDK refuses sk_* keys; pass via SSR client
// or your own server proxy (browser-side calls return 403).
const list = await sendora.audiences.list();

const aud = await sendora.audiences.create({
  name: "Active Pro users — last 30d",
  description: "Pro plan + recent feature usage",
  rules: {
    all: [
      { trait: "plan", op: "eq", value: "pro" },
      { event: "feature_used", op: "occurred_in_last", value: "30d" },
      {
        any: [
          { trait: "country", op: "eq", value: "US" },
          { trait: "country", op: "eq", value: "CA" },
        ],
      },
    ],
  },
});

await sendora.audiences.update("<AUDIENCE_UUID>", {
  name: "Active Pro users — extended to 60d",
  rules: {
    all: [
      { trait: "plan", op: "eq", value: "pro" },
      { event: "feature_used", op: "occurred_in_last", value: "60d" },
    ],
  },
});

await sendora.audiences.delete("<AUDIENCE_UUID>");

curl -X POST https://api.sendoracloud.com/api/v1/orgs/<ORG_UUID>/push/send \
  -H "x-api-key: pk_prod_…" \
  -d '{
    "audienceId": "<AUDIENCE_UUID>",
    "title": "Sale starts now",
    "body": "20% off everything"
  }'

Related