Skip to main content
POST
Cria um fluxo completo (e, se pedido, publica)

Authorizations

Authorization
string
header
required

Authorization: Bearer mcp_… — gere em Configurações → Tokens de API.

O token de API tem modo read ou write. Um token read responde 403 a qualquer verbo que não seja GET. As capacidades do token são a interseção com as da pessoa de quem ele herda o papel: se ela perder acesso na grade de Equipe, o token perde junto, sem ninguém revogar nada.

Token de agência (gerado no console da agência): vale para as empresas da agência, e a empresa de cada chamada vai no header X-Empresa: <slug da empresa>. Sem o header, 401. Num token de empresa o header é opcional e, se vier, tem de ser a própria empresa. O modo read vale igual: um token de agência de leitura só faz GET — é o token para pôr numa função que só consulta.

Body

application/json
nome
string
required

Espaços repetidos viram um. É a chave da idempotência.

Maximum string length: 80
grafo
object
required

O desenho do fluxo, no formato do editor (até 60 peças e 120 ligações).

pipeline_id
string<uuid>

O funil. Omitido, vale o principal da empresa (o primeiro da lista).

ajustes
object
posts
string[]

Ids de mídia da Graph, como string (com 17 dígitos ou mais o número perde precisão). Só em fluxo com comentou.

Maximum array length: 20
Pattern: ^[0-9]{1,64}$
ligar_auto
object

Ligar post automático (ADR 0080): liga sozinho, a este fluxo, os posts novos da conta (publicados depois de a regra ser ligada). Uma das duas regras: legenda_contem (a legenda tem um termo que começa com isto) ou todo_reels_novo: true. codigo_prefixo (opcional) escolhe o {{post.codigo}}: o 1º termo da legenda que começa com ele; sem ele, o termo que bateu, sem o #.

publicar
boolean
default:false

Response

Criado (rascunho, ou publicado e ligado)

id
string<uuid>
nome
string
versao
integer

A versão publicada

status
enum<string>

active = publicado e ligado.

Available options:
draft,
active
veredito
object

O que a validação de publicar achou — a mesma lista da tela.

vale_para
enum<string> | null

Só em fluxo com o gatilho comentou. todos = nenhum post ligado (só possível em rascunho).

Available options:
todos,
ligados,
null
posts
object[]