---
title: "Criar webhook de aplicação"
method: POST
path: "/open-keys/itp/api/v2/applications/{applicationId}/webhooks"
tags: ["Webhooks da Aplicação"]
---

# Criar webhook de aplicação

`POST /open-keys/itp/api/v2/applications/{applicationId}/webhooks`

Cria uma configuração de webhook para uma aplicação receber notificações sobre eventos de pagamento e mudanças de status de jornada. Suporta vários métodos de autenticação incluindo chave API, autenticação básica e token de portador.

## Path parameters

- `applicationId` string, required

## Request body

- CreateApplicationWebhook
  - `endpointBaseUrl` string, uri, required — URL de destino
  - `authentication` CreateApplicationWebhookAuthentication, required
    - `authType` 'no_auth' | 'api_key' | 'basic_auth' | 'bearer_token', required
    - `data` CreateApplicationWebhookAuthenticationData
      - `name` string
      - `value` string
      - `token` string
      - `username` string
      - `password` string
    - `add_position` 'header'

## Response `200`

retornou com sucesso.

- ApplicationWebhook
  - `id` string, required — O ID do webhook da aplicação.
  - `createdAt` string, required
  - `updatedAt` string, required
  - `deletedAt` string, required
  - `applicationId` string, required — O ID da aplicação. É um número exclusivo que identifica a aplicação.
  - `endpointBaseUrl` string, uri, required — URL de destino
  - `authentication` ApplicationWebhookAuthentication, required
    - `authType` 'no_auth' | 'api_key' | 'basic_auth' | 'bearer_token', required
    - `data` ApplicationWebhookAuthenticationData
      - `name` string
      - `value` string
      - `token` string
      - `username` string
      - `password` string
    - `add_position` 'header'

## Other responses

- `401` — Authentication is required to access this resource. The client must provide valid credentials.
- `403` — The server understood the request but refuses to authorize it. Access is permanently forbidden and tied to the application logic.
- `409` — The request conflicts with the current state of the resource on the server.
- `422` — The request contains invalid or malformed data that cannot be processed.
- `500` — An unexpected error occurred on the server while processing the request.
- `default` — Unexpected error.

---

[API](https://skmtc.net/celcoin/apis/api-para-transa-es.md) · [All operations](https://skmtc.net/celcoin/apis/api-para-transa-es/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/celcoin/api-para-transa-es/revisions/85dd6188a37b/schema)