Skip to main content
POST
Create a flow

Authorizations

Authorization
string
header
required

Your API key, e.g. sk_live_... or sk_test_....

Headers

Idempotency-Key
string

Optional. Makes this write safe to retry: the same key replays the first response instead of acting twice.

Maximum string length: 255

Body

application/json
name
string
required
Maximum string length: 200
categories
string[]
required
Minimum array length: 1
Maximum string length: 64
flow_json
any
required

The Flow JSON document, as an object or string.

data_endpoint_uri
string

Must be https.

Maximum string length: 2048
public_key
string
Maximum string length: 8192

Response

Created.

uuid
string
name
string
status
string
categories
string[]
provider_flow_id
string | null
version
string | null
data_endpoint_uri
string | null
endpoint_health
object
published_at
string<date-time> | null
created_at
string<date-time> | null
can_send_message
string | null

Meta's last answer from the health check: AVAILABLE, LIMITED or BLOCKED.

health_checked_at
string<date-time> | null
endpoint_secret
string

Present only when the flow has a data_endpoint_uri. LazyApp signs every request it forwards to that endpoint with this secret as X-LazyApp-Signature: sha256=<HMAC-SHA256 of the body>. Shown only here and by rotate-endpoint-secret, so store it.

Example:

"whfs_9fKx2..."