Criar rascunho de formulário

POST
/v1/forms

Cria um formulário não publicado: título, campos (save_to diz qual campo do contato a resposta preenche), texto de agradecimento, uma tag para quem envia e uma automação que cada resposta inicia. publish_form o coloca no ar.

Escopo: forms:write

Autorização

bearer forms:write
headerAutorizaçãoBearer <token>

A chave de API de uma conta de serviço (sk_live_…, 600 requisições por minuto cada) ou um access token OAuth para o recurso /api/v1 (600 requisições por minuto por conexão).

Escopo: forms:write

Cabeçalhos

Idempotency-Key?string

Até 200 letras, dígitos, - ou _. A primeira resposta a uma chave é repetida por 24 horas.

Tamanholength <= 200
application/json
  1. body
title*string

The form's name, in the person's language.

Tamanho1 <= length <= 120
description*|

The line under the title on the public page; null for none.

fields*array<>
Itens1 <= items <= 20
thanks*|

What the page says once sent; null for the default.

tag*|

A tag added to whoever sends it, found or created by name; null for none.

automation*|

An existing automation that a submission starts, by name; null unless the person named one.

Corpo da resposta

Feito.

application/json
  1. response
id*string
Exemplo de requisição
curl -X POST 'https://app.zaplin.com.br/api/v1/forms' \  -H 'Authorization: Bearer sk_live_...' \  -H 'Content-Type: application/json' \  -d '{  "title": "string",  "description": "string",  "fields": [    {      "type": "short_text",      "label": "string",      "required": true,      "save_to": "string",      "options": [        "string"      ]    }  ],  "thanks": "string",  "tag": "string",  "automation": "string"}'
Exemplo de resposta
{  "id": "string"}