Digital Onboarding v2 API
The partner platform contract — typed end-to-end, scoped by surface, with a typed event log, insight envelope, and bulk lifecycle. Generated from the v2 OpenAPI spec set authored alongside the gondor build (Slices 1–18 shipped).
Cross-cutting concepts
Auth & Scopes
OAuth client_credentials, the scope grammar (partner:contacts:read), and how the surface boundary enforces it at the router. The shadow-API closure model.
Insight Envelope
Every cached insight returns InsightResponse<T> with a typed value, computed_at, expires_at, and a 202 cache_warming contract for first computes.
Mutations & Idempotency
The Idempotency-Key header semantics. Replay on same key + body returns cached response; different body → 409 idempotency_conflict.
Batch Lifecycle
Typed Batch resource with state machine + error report + replay. Source kinds: inline, signed_url, s3, sftp.
Surfaces
Campaigns
Templates, Pages, Messages, Journeys. The objects partners create and ship.
Audience
Contacts, Accounts, Cohorts, Audiences. Who you target.
Outcomes
Objectives, Products, Services, Rewards. What success looks like.
Engagement
Events and per-contact engagement summaries. The data spine.
Insights
42 typed insight payloads. No more value: object.
Operations
Team, Users, OAuth, Approvals, Files, Widgets, Webhooks, SFTP.
Batch
Typed bulk operations. CSV/JSONL via inline / signed URL / S3 / SFTP.
Inbound Webhooks
Provider receivers (SendGrid, Twilio, Firebase). HMAC verification.