/flows/:slug

GET / POST

Flow content and event tracking endpoints.

Overview#

These endpoints serve flow content and track flow events. They're called automatically by the React Native SDK when you use startFlow().

If you're building a native iOS, Android, or Flutter app without React Native, you can use these endpoints directly to integrate flows into your app. Fetch the flow HTML/CSS/JS, render it in a WebView, and use the event endpoint to track user interactions.

Native SDKs Coming Soon

We're working on native Swift and Kotlin SDKs that will handle all of this for you. In the meantime, these endpoints give you everything you need to build a custom integration.

Get Flow Content#

Endpoint

GET https://YOUR_APP_ID.mobana.ai/flows/:slug

Request

GET https://YOUR_APP_ID.mobana.ai/flows/onboarding?installId=520e8400-c466-a554-40e0-0

Parameter	Type	Description
`slug`Required	`string`	Flow slug/identifier (in URL path)
`installId`Required	`string`	Install ID for analytics and A/B assignment
`versionId`	`string`	Cached version ID. If provided and matches current version, returns `cached: true` instead of full content.

Response (Success)

Response

{
  "versionId": "clx123abc",
  "html": "<!DOCTYPE html>...",
  "css": ".container { ... }",
  "js": "document.addEventListener('DOMContentLoaded', ...)"
}

Property	Type	Description
`versionId`	`string`	Unique version identifier
`html`	`string`	Flow HTML content
`css`	`string`	Flow CSS (may be embedded in HTML)
`js`	`string`	Flow JavaScript (may be embedded in HTML)

Response (Cached)

If the client's cached version matches the current version:

Response

{
  "cached": true
}

Response (Error)

Response

{
  "error": "NOT_FOUND"
}

Property	Type	Description
`error`	`string`	Error code: `NOT_FOUND`, `PLAN_REQUIRED`, or `FLOW_LIMIT_EXCEEDED`

Track Flow Event#

Endpoint

POST https://YOUR_APP_ID.mobana.ai/flows/:slug/events

Request

POST https://YOUR_APP_ID.mobana.ai/flows/onboarding/events
Content-Type: application/json

{
  "installId": "520e8400-c466-a554-40e0-0",
  "versionId": "clx123abc",
  "sessionId": "session-uuid-123",
  "event": "step_1_completed",
  "data": { "selectedOption": "premium" }
}

Parameter	Type	Description
`slug`Required	`string`	Flow slug/identifier (in URL path)
`installId`Required	`string`	Install ID
`versionId`Required	`string`	Flow version that was shown
`sessionId`Required	`string`	Unique session ID for this flow presentation
`event`Required	`string`	Event name (e.g., 'step_1_completed', '__completed__')
`step`	`number`	Optional step number for multi-step flows
`data`	`object`	Optional event data (stored as JSON)

Response

{ "success": true }

Silent Success

Like /conversion, this endpoint uses the silent success pattern. It always returns success, even for invalid requests.

System Events#

These events are tracked automatically by the SDK:

__started__ — Flow was shown
__completed__ — User completed the flow
__dismissed__ — User dismissed the flow

A/B Testing#

When a flow has multiple published versions, the API randomly assigns one based on the install ID. The same install always sees the same version, enabling consistent A/B testing.

/conversion