---
title: "Criar um webhook"
method: POST
path: "/integrations/webhooks"
tags: ["Subscriptions"]
---

# Criar um webhook

`POST /integrations/webhooks`

Cria uma assinatura de webhook na conta que a sua integração está vinculada. Os webhooks criados não serão listados na tela do RD Station Marketing.

## Request body

- object
  - `event_type` 'WEBHOOK.CONVERTED' | 'WEBHOOK.MARKED_OPPORTUNITY' | 'crm_deal_created' | 'crm_deal_updated' | 'crm_deal_deleted', required — O tipo de evento que aciona a solicitação de webhook. Atualmente somente eventos de negociação, conversão e oportunidade são suportados
  - `entity_type` 'CONTACT', required — A entidade da assinatura do webhook. Por enquanto, 'CONTATO' é a única opção aceita
  - `event_identifiers` string[] — Os identificadores dos eventos que devem acionar o webhook. Apenas para eventos 'WEBHOOK.CONVERTED'
  - `url` string, required — A URL de destino do webhook
  - `http_method` 'POST', required — O método http que o webhook acionará. Atualmente, apenas o método 'POST' é suportado
  - `include_relations` string[] — Quais itens adicionais serão fornecidos no payload do webhook. Apenas 'COMPANY' e 'CONTACT_FUNNEL' são opções válidas

## Response `201`

Created

- object
  - `created_at` string — Data de criação do Webhook
  - `updated_at` string — Data da última atualização do Webhook
  - `event_identifiers` string[] — Permite filtrar os identificadores do evento que aciona o webhook. Apenas para eventos 'WEBHOOK.CONVERTED'
  - `event_type` string — O tipo de evento que aciona a solicitação de webhook
  - `entity_type` string — A entidade da assinatura do webhook
  - `http_method` string — O método http que o webhook acionará
  - `include_relations` string[] — Quais itens adicionais serão fornecidos no payload do webhook
  - `platform_account_id` number — Identificador da conta
  - `source` string — Fonte do evento. Temos 2 no momento, MKT ou CRM
  - `status` string — O status do webhook, cujo valor padrão é 'active'
  - `url` string — A URL de destino do webhook
  - `uuid` string — O uuid exclusivo associado a cada assinatura de webhook do RD Station

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

---

[API](https://skmtc.net/rdstation/apis/webhook-service.md) · [All operations](https://skmtc.net/rdstation/apis/webhook-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rdstation/webhook-service/revisions/3867c21388e8/schema)