Saltar al contenido principal
POST
Crear flow como borrador

Autorizaciones

Authorization
string
header
requerido

Clave API creada en la configuración de la organización.

Encabezados

Idempotency-Key
string

Clave única de la operación. Repetir la misma clave con el mismo cuerpo devuelve la respuesta original en lugar de ejecutarla de nuevo.

Cuerpo

application/json
name
string
requerido
Required string length: 1 - 256
trigger
object
requerido

Disparador del flow, como aparece en el catálogo.

start
string
requerido

Clave del bloque: letras minúsculas, números y guiones bajos, empezando por una letra.

Pattern: ^[a-z][a-z0-9_]{0,63}$
Ejemplo:

"wait_1_day"

nodes
object[]
requerido
Required array length: 1 - 50 elements

Divide el camino según un campo de los datos del disparador.

description
string
Maximum string length: 2000
validate_only
boolean
predeterminado:false

Si es true, solo valida el flow y devuelve el resumen, sin guardar nada.

Respuesta

Flow validado o guardado como borrador.

object
string
requerido
Allowed value: "flow_draft"
validate_only
boolean
requerido

true cuando el flow solo se validó; no se guardó nada.

status
string
requerido
Allowed value: "draft"
trigger
object
requerido
outline
string[]
requerido

Pasos del flow en lenguaje simple.

warnings
object[]
requerido

Avisos que no impiden el borrador, como una plantilla de WhatsApp todavía en revisión por Meta.

next_step
string
requerido
id
string
Pattern: ^flw_[A-Za-z0-9_-]+$
revision
string

Revisión del borrador guardado. Envíala al activar el flow después de revisarlo.

html_url
string<uri>

Enlace del flow en el editor de Bevits, para revisarlo.