---
title: "Registrar novo evento webhook"
method: POST
path: "/v1/marketplace/hooks/hook-events"
tags: ["Gerenciamento de webhooks"]
---

# Registrar novo evento webhook

`POST /v1/marketplace/hooks/hook-events`

## Headers

- `integration-key` string, required
- `x-token` string, required

## Request body

- CreateWebhooksDto
  - `events` CreateWebhookEventDto[], required — Lista de webhooks a serem criados ou atualizados.
    - `event_id` number, required — ID do evento.
    - `active` boolean, required — Define se o webhook está ativo.
    - `url` string — URL de recebimento do webhook (obrigatória se ativo).
    - `basic_user` string — Usuário para autenticação básica.
    - `basic_pass` string — Senha para autenticação básica.

## Response `200`

- IntegrationFormattedResponse
  - `events` HookEventIntegration[], required
    - `id` number, required — ID do evento.
    - `name` string, required — Nome do evento.
    - `description` string, required — Descrição do evento.
    - `active` boolean, required
    - `url` string, nullable, required — URL de recebimento do webhook.
    - `basic_user` string, nullable, required — Basic user para autenticação.
    - `basic_pass` string, nullable, required — Basic password para autenticação.

---

[API](https://skmtc.net/paytime/apis/api-p-blica.md) · [All operations](https://skmtc.net/paytime/apis/api-p-blica/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/paytime/api-p-blica/revisions/5c818991d183/schema)