Create an in-app flow: a graph of steps, each displaying a screen, that the SDK opens through the deeplink ply/flows/<vendor_id>

post

https://api.purchasely.io/management/v1/applications/{application_id}/flows

Create an in-app flow: a graph of steps, each displaying a screen, that the SDK opens through the deeplink ply/flows/<vendor_id>. Send the same content as draft_content to publish it right away.

Required scope: experiences.flows:create

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

application_id

string

required

Public ID of the resource.

Query Params

fields

array of strings

Field selection for token economy: an explicit list of field names to include in the response, or ["*"] for every field. Omit for this endpoint's own default field set.

fields

Body Params

app_flow

boolean

Defaults to true.

content

object

Published content. Send the same value as draft_content to publish on creation.

default_presentation_store_public_id

string

Screen public id (pres_…) shown when a step cannot be resolved.

draft_content

object

Draft content edited in the console before publishing.

name

string

required

Display name shown in console.

vendor_id

string

required

Stable machine identifier used by the SDK deeplink ply/flows/<vendor_id>; unique within the app.

web_flow

boolean

Must be false: web2app flows are not available on this API.

Responses

201Success.

403FORBIDDEN (missing/insufficient scope, wrong tenant) or, for feature-gated operations, FEATURE_NOT_ENABLED.

422VALIDATION_FAILED — one or more parameters were missing or invalid.

429RATE_LIMITED — the coarse per-key, per-write, per-heavy-read, or per-moderate-read rate limit tier was exceeded.