Flows / Publish flow

Publish flow

POST/v1/flows/{id}/publish

Validate the flow and push it live to the delivery service. Once published it starts delivering conversions. If the delivery service is unavailable you get a 502, which is safe to retry.

Path parameters

string · required

The flow id.

Response fields

string

Prefixed identifier, e.g. flow_0Dzj….

site_id

string

The site this flow belongs to.

name

string

Up to 255 characters.

status

string

draft (not delivering), published (live), or archived.

trigger_config

object | null

What fires the flow, e.g. { integrationId, pageFilter }.

trigger_name

string | null

Resolved display name of the trigger, e.g. Gravity Forms.

actions_config

array | null

The destinations that receive the conversion.

published_at

timestamp | null

When it was last published. null while in draft.

Run Validate flow first if you want to surface any problems before publishing. Publishing a flow on an expired trial or lapsed subscription returns 402.

POST/v1/flows/{id}/publish

curl -X POST https://app.converly.io/api/v1/flows/flow_0Dzj…/publish \
  -H "Authorization: Bearer sk_live_…"

200 OK

{
  "id": "flow_0Dzj…",
  "status": "published",
  "published_at": "2026-06-30T12:05:00.000Z"
}