---
title: "Cadastrar e Atualizar Inscrição no Webhook"
method: POST
path: "/configuracoes/topico-webhook"
---

# Cadastrar e Atualizar Inscrição no Webhook

`POST /configuracoes/topico-webhook`

## Request

- Base URL: `https://domain.sintesesolucoes.com.br/SinOMS.API`
- URL: `https://domain.sintesesolucoes.com.br/SinOMS.API/configuracoes/topico-webhook`
- Auth: none required

Endpoint público para cadastro e atualização de inscrição no Webhook por tópico

## Request body

- object
  - `id` integer: Id gerado ao se inscrever em um tópico. Para inclusão, enviar o valor null, para atualização, enviar o Id que deseja atualizar.
  - `topico` string: Tópico ao qual está se inscrevendo.
  - `url` string, required: URL da API e endpoint que o Webhook irá notificar.
  - `filtros` object: Filtro possíveis
    - `contasOms` string[]: Nomenclatura da conta que deseja consultar. Caso deseje consultar todas as contas, utilize "*", caso deseje consultar contas específicas, utilize o separado;
    - `contasOmsIgnorar` string[]: Este parâmetro pode ser utilizado para excluir alguma conta da inscrição.
    - `idsStatus` string[]: Filtro por status do pedido. O Webhook funcionará apenas para os status mencionados neste campo.
  - `headers` object[]: Header que será enviado no request, composto por chave e valor. Caso não precise, enviar null
    - `chave` string: Chave que será utilizada para autenticação
    - `valor` string: Valor necessário para acessar API
  - `email` string: E-mail que será usado para disparar aviso caso uma conta seja inativada por limite de tentativas
  - `observacao` string: campo onde é possível guardar informações sobre o motivo da inscrição no tópico
  - `inativo` boolean: Status da inscrição.

## Response `200`

200

- object
  - `mensagem` string
  - `dados` unknown

## Other responses

- `400`: 400

---

[API](https://skmtc.dev/fbits/apis/wake-oms-api.md) - [All operations](https://skmtc.dev/fbits/apis/wake-oms-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fbits/apis/wake-oms-api/revisions/00fc8618a083?raw)