---
title: "/v1/subscription"
method: POST
path: "/v1/subscription"
---

# /v1/subscription

`POST /v1/subscription`

Ednpoint responsável por cadastrar uma nova subscription

## Request body

- object
  - `name` string, required — Nome
  - `endpointUrl` string, required — Url do enpoint à ser acionado
  - `body` string, json, required — Parâmetros da requisição à ser realizada, levando em conta os campos disponíveis de acordo com o tipo de evento
  - `headers` string, json — Cabeçalhos necessários para execução do endpoint associado
  - `retries` integer, required — Número de retentativas em caso de falha
  - `timeout` integer, required — Tempo em segundos para aguardar resposta do endpoint acionado
  - `isActive` string — Indica se a subscription está ativa ou não
  - `webHookEventType` string, required — Tipo do evento à ser associado. Lista de disponíveis pode ser consultada em "GET v1/webhookevent

## Response `201`

201

- object
  - `code` integer
  - `success` boolean
  - `data` unknown
  - `errors` unknown

## Other responses

- `400` — 400

---

[API](https://skmtc.net/totvs/apis/api-identityintegration-autentica-o.md) · [All operations](https://skmtc.net/totvs/apis/api-identityintegration-autentica-o/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/totvs/api-identityintegration-autentica-o/versions/0f43855140b5/schema)