---
title: "Criar Gatilho"
method: POST
path: "/web_hooks"
---

# Criar Gatilho

`POST /web_hooks`

## Request

- Base URL: `https://api.iugu.com/v1`
- URL: `https://api.iugu.com/v1/web_hooks`
- Auth: API key in query parameter `api_token`

Cria um gatilho

## Request body

- object
  - `event` string, required: Nome do evento desejado. Acesse a lista com todos os eventos e descrição [aqui](https://dev.iugu.com/docs/gatilhos).
  - `url` string, required: Endpoint para qual o gatilho será enviado
  - `authorization` string: Grave uma chave / key para usar como "Basic Authentication" na validação do recebimento dos gatilhos.

## Response `200`

200

- object
  - `id` string
  - `url` string
  - `authorization` unknown
  - `event` string
  - `active` boolean

## Other responses

- `400`: 400

---

[API](https://skmtc.dev/iugu/apis/gatilhos.md) - [All operations](https://skmtc.dev/iugu/apis/gatilhos/llms.txt) - [OpenAPI document](https://skmtc.dev/iugu/apis/gatilhos/revisions/352b56b86fe3?raw)