---
title: "Criar publicação"
method: POST
path: "/api/management/form-publications"
tags: ["form-publications"]
---

# Criar publicação

`POST /api/management/form-publications`

Publica um formulário em um link aberto, com token gerado automaticamente. Com `create_project`, cada resposta cria um projeto na etapa escolhida, gravando as respostas no conteúdo ou como formulário avulso. Ver [Publicações de formulários](https://docs.olie.ai/guides/forms/public-forms).

## Request body

- object — Configuração da publicação.
  - `title` string, required — Título exibido no formulário público (até 255 caracteres).
  - `description` string, nullable — Descrição exibida dentro do formulário (até 255 caracteres).
  - `background_color` string, nullable — Cor de fundo em hexadecimal, com 3 ou 6 dígitos (ex.: #1E40AF). Nulo usa a cor padrão.
  - `starts_at` string, nullable — Início da janela de publicação. Nulo: vale imediatamente.
  - `ends_at` string, nullable — Fim da janela de publicação; igual ou posterior a starts_at. Nulo: não expira.
  - `redirect_url` string, uri, nullable — URL para onde quem responde é levado após enviar (até 2048 caracteres).
  - `status` 'published' | 'unpublished', required — published liga o link público; unpublished o desliga.
  - `form_id` integer, required — ID do formulário a publicar.
  - `create_project` boolean, nullable — Se cada resposta cria um projeto. Quando não é true, os campos de criação de projeto abaixo são descartados.
  - `link_as_media` boolean, nullable — Grava as respostas no conteúdo do projeto criado. Com create_project, este ou link_as_loose_form precisa ser true.
  - `link_as_loose_form` boolean, nullable — Grava as respostas como formulário avulso do projeto criado.
  - `project_name` string, nullable — Nome fixo do projeto criado (até 255 caracteres). Ignorado quando form_edge_id é enviado.
  - `form_edge_id` integer, nullable — Campo do formulário cuja resposta vira o nome do projeto. Precisa ser do formulário publicado e respondível em link público.
  - `project_template_id` string, uuid, nullable — Modelo de projeto usado para criar o projeto.
  - `funnel_step_id` integer, nullable — Etapa de funil em que o projeto criado é vinculado.

## Response `201`

Sucesso

- object — Publicação criada.
  - `response` boolean — Indicador de sucesso da requisição. Sempre true nas respostas bem-sucedidas.
  - `form_publication` object — Publicação criada.
    - `id` string, uuid — ID da publicação.
    - `title` string — Título exibido no formulário público.
    - `description` string, nullable — Descrição exibida dentro do formulário para quem responde.
    - `background_color` string, nullable — Cor de fundo do formulário público, em hexadecimal. Nulo usa a cor padrão.
    - `starts_at` string, date-time, nullable — Início da janela de publicação. Nulo: vale desde a criação.
    - `ends_at` string, date-time, nullable — Fim da janela de publicação. Nulo: não expira.
    - `redirect_url` string, nullable — Endereço para onde quem responde é levado após enviar.
    - `token` string, uuid — Token do link público do formulário.
    - `status` 'published' | 'unpublished' — Situação da publicação: published (link ativo) ou unpublished (link desligado).
    - `form_id` integer — ID do formulário publicado.
    - `frame_id` string, uuid — ID da conta dona da publicação.
    - `created_at` string, date-time — Data de criação da publicação.
    - `updated_at` string, date-time — Data da última alteração da publicação.
    - `create_project` union — Se cada resposta cria um projeto. Pode vir como 0/1 na leitura.
      - boolean
      - integer
    - `link_as_media` boolean — Se as respostas são gravadas no conteúdo do projeto criado.
    - `link_as_loose_form` boolean — Se as respostas são gravadas como formulário avulso do projeto criado.
    - `project_name` string, nullable — Nome fixo do projeto criado. Usado quando form_edge_id está vazio.
    - `form_edge_id` integer, nullable — ID do campo cuja resposta vira o nome do projeto criado.
    - `project_template_id` string, uuid, nullable — ID do modelo de projeto usado para criar o projeto.
    - `funnel_step_id` integer, nullable — ID da etapa em que o projeto criado é vinculado.
    - `type` 'publication' — Tipo do registro. Sempre publication neste endpoint.

## Other responses

- `422` — Validação falhou

## Changes

- **2026-09-22** `d8fb547e20a2` — 16 breaking, 9 warning, 12 info
  - added the new required request property `form_id`
  - added the new required request property `status`
  - added the new required request property `title`
  - the request's body type changed from `array` to `object`
  - …33 more
- **2026-09-22** `d71b18b1685d` — 1 breaking, 2 info
  - removed the success response with the status `200`
  - added the non-success response with the status `422`
  - added the success response with the status `201`

[Change history](https://skmtc.dev/olie-ai/apis/olie-api/changes/api/management/form-publications/post.md)

---

[API](https://skmtc.dev/olie-ai/apis/olie-api.md) · [All operations](https://skmtc.dev/olie-ai/apis/olie-api/llms.txt) · [OpenAPI document](https://skmtc.dev/olie-ai/apis/olie-api/revisions/d7bda7d32f67?raw)