---
title: "Criar"
method: POST
path: "/hooks"
tags: ["Webhooks"]
---

# Criar

`POST /hooks`

Cria um novo gatilho para receber notificações de eventos.

## Request body

- HookCreateRequest
  - `cnpj` string — CNPJ da empresa
  - `cpf` string — CPF do prestador de serviço
  - `event` 'nfe' | 'nfse' | 'nfsen' | 'nfce_contingencia' | 'nfe_recebida' | 'nfe_recebida_falha_consulta' | 'nfse_recebida' | 'cte_recebida' | 'inutilizacao' | 'cte' | 'mdfe' | 'nfcom' | 'nfsen_recebida' | 'dce', required — Evento a ser monitorado
  - `url` string, uri, required — URL que receberá as notificações
  - `authorization` string, nullable — Valor a ser enviado no cabeçalho de autorização
  - `authorization_header` string, nullable — Nome do cabeçalho HTTP a ser utilizado para enviar o campo authorization

## Response `200`

Gatilho criado com sucesso

- Hook
  - `id` string
  - `url` string, uri
  - `authorization` string, nullable
  - `authorization_header` string, nullable
  - `event` 'nfe' | 'nfse' | 'nfsen' | 'nfce_contingencia' | 'nfe_recebida' | 'nfe_recebida_falha_consulta' | 'nfse_recebida' | 'cte_recebida' | 'inutilizacao' | 'cte' | 'mdfe' | 'nfcom' — Evento monitorado
  - `cnpj` string — CNPJ vinculado ao gatilho
  - `cpf` string — CPF vinculado ao gatilho

## Other responses

- `400` — Requisição inválida
- `404` — Recurso não encontrado

---

[API](https://skmtc.net/focusnfe/apis/cte-cte-os-e-cte-simplificado-conhecimento-de-transporte-ele.md) · [All operations](https://skmtc.net/focusnfe/apis/cte-cte-os-e-cte-simplificado-conhecimento-de-transporte-ele/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/focusnfe/cte-cte-os-e-cte-simplificado-conhecimento-de-transporte-ele/revisions/a32e528fc383/schema)