---
title: "Cria um aceite"
method: POST
path: "/api/v1/acceptances"
tags: ["Acceptances"]
---

# Cria um aceite

`POST /api/v1/acceptances`

## Request

- Base URL: `http://app-acceptance-sandbox.clicksign.com`
- URL: `http://app-acceptance-sandbox.clicksign.com/api/v1/acceptances`
- Auth: API key in header `X-API-Key` and API key in header `X-API-Secret`

Cria um novo fluxo de aceite. O serviço persiste o registro, publica na fila interna e retorna imediatamente com status `PENDING` — a validação do template e o envio da mensagem ao canal acontecem de forma assíncrona. O `channel_params` da requisição não contém a definição completa do template (nome, idioma) — apenas os valores das variáveis por passo; a definição fica armazenada do lado da Clicksign, associada ao `template_id`.

## Request body

- object
  - `execution_id` string, required: ID do fluxo/execução no seu sistema, para correlação.
  - `channel_type` 'whatsapp', required: Canal de entrega. Único valor válido hoje: `whatsapp`.
  - `destination` string, required: Destinatário no formato do canal (ex.: número E.164 para WhatsApp).
  - `template_id` string, required: ID do template cadastrado junto à Clicksign para a sua conta.
  - `channel_params` object, required: Variáveis de preenchimento do template, por passo (`steps[]`). Passos do tipo `text` (mensagens automáticas de fechamento) não precisam ser declarados aqui.
    - `steps` object[]
      - `step_id` string
      - `sequence` integer
      - `type` 'template' | 'text'
      - `content` object
  - `metadata` object: Dados livres associados ao aceite — devolvidos no relatório e no recibo final (ex.: identificadores de contrato, nome/e-mail do destinatário).
  - `webhook_url` string, uri: URL que receberá o recibo final (POST) quando o aceite atingir um status final. Opcional — se omitido, o recibo não é entregue via HTTP (o histórico continua disponível via GET /api/v1/reports/{id}).
  - `expiration_time` integer: Tempo de expiração em segundos a partir da criação. Se omitido, usa o padrão do serviço.

## Response `201`

Aceite criado e enfileirado para processamento assíncrono.

- object

## Other responses

- `400`: Payload inválido, campo obrigatório ausente ou `channel_type` inválido.
- `401`: Credencial ausente ou inválida.
- `403`: Credencial revogada.
- `422`: Template não encontrado para a credencial e o `template_id` informados.

---

[API](https://skmtc.dev/clicksign/apis/m-dulos-de-aceite-e-de-notifica-o.md) - [All operations](https://skmtc.dev/clicksign/apis/m-dulos-de-aceite-e-de-notifica-o/llms.txt) - [OpenAPI document](https://skmtc.dev/clicksign/apis/m-dulos-de-aceite-e-de-notifica-o/revisions/18547508ff90?raw)