Criar uma enquete

Atualizado em 17 de outubro de 2026

Considerações

Exige o escopo surveys:write e a permissão Enquetes (criar) do usuário responsável.
Tipos: radio (escolha única), checkbox (múltipla), options (lista), text e textarea. Escolha precisa de ao menos duas opções.
Com audience: link, a resposta traz public_url para clientes responderem sem login.
Depois de criadas, as perguntas são editadas pelo construtor de Formulários no painel.
Exige Idempotency-Key: repetir a chave com o mesmo corpo devolve o resultado original, sem repetir a operação.

Referência

Como fazer

cURL

curl -X POST "$MICORE_BASE_URL/surveys" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json" \
  -H "Idempotency-Key: request-2026-0001" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Pesquisa de satisfação",
    "audience": "link",
    "ends_at": "2026-11-15T23:59:00-03:00",
    "questions": [
        {
            "name": "Você recomendaria a loja?",
            "type": "radio",
            "required": true,
            "options": [
                "Sim",
                "Não",
                "Talvez"
            ]
        },
        {
            "name": "O que podemos melhorar?",
            "type": "textarea"
        }
    ]
}'

Resposta

Resposta · 201

{
    "data": {
        "id": 1,
        "name": "string",
        "description": null,
        "state": "open",
        "active": true,
        "audience": "team",
        "anonymous": true,
        "allow_multiple": true,
        "starts_at": "2026-10-20T10:00:00-03:00",
        "ends_at": "2026-10-20T10:00:00-03:00",
        "thank_you_message": null,
        "public_url": null,
        "responses_count": 1,
        "questions": [
            {
                "key": "field_9b2f6c1e-3a4d-4b8e-a1c2-7d5e6f708192",
                "name": "string",
                "description": null,
                "type": "radio",
                "required": true,
                "options": [
                    "string"
                ]
            }
        ],
        "created_at": "2026-10-20T10:00:00-03:00",
        "updated_at": "2026-10-20T10:00:00-03:00"
    }
}

Precisa de ajuda?Use o request ID e abra um chamado no miCore se encontrar uma divergência.