---
title: "Criar webhook"
method: POST
path: "/webhooks"
tags: ["crm-v2-webhooks"]
---

# Criar webhook

`POST /webhooks`

Criar um webhook.

## Request body

- object
  - `data` object — Dados do recurso relacionado.
    - `id` string, uuid — Identificador único.
    - `name` string — Nome do webhook.
    - `event_name` 'crm_campaign_created' | 'crm_campaign_deleted' | 'crm_campaign_updated' | 'crm_contact_created' | 'crm_contact_deleted' | 'crm_contact_updated' | 'crm_deal_created' | 'crm_deal_deleted' | 'crm_deal_updated' | 'crm_lost_reason_created' | 'crm_lost_reason_deleted' | 'crm_lost_reason_updated' | 'crm_organization_created' | 'crm_organization_deleted' | 'crm_organization_updated' | 'crm_product_created' | 'crm_product_deleted' | 'crm_product_updated' | 'crm_proposal_created' | 'crm_source_created' | 'crm_source_deleted' | 'crm_source_updated' | 'crm_task_created' | 'crm_task_deleted' | 'crm_task_updated' — Nome do evento do webhook.
    - `http_method` 'POST' — Método HTTP do webhook.
    - `url` string, url — URL do webhook.
    - `status` 'active' | 'suspended' | 'inactive' — Status do webhook.
    - `auth_header` string — Nome do header de autenticação do webhook.
    - `auth_key` string — Chave de autenticação do webhook.
    - `created_at` string, date-time — Data de criação do webhook
    - `updated_at` string, date-time — Data de atualização do webhook.

## Response `201`

Created

- object
  - `data` object — Dados do recurso relacionado.
    - `id` string, uuid — Identificador único.
    - `name` string — Nome do webhook.
    - `event_name` 'crm_campaign_created' | 'crm_campaign_deleted' | 'crm_campaign_updated' | 'crm_contact_created' | 'crm_contact_deleted' | 'crm_contact_updated' | 'crm_deal_created' | 'crm_deal_deleted' | 'crm_deal_updated' | 'crm_lost_reason_created' | 'crm_lost_reason_deleted' | 'crm_lost_reason_updated' | 'crm_organization_created' | 'crm_organization_deleted' | 'crm_organization_updated' | 'crm_product_created' | 'crm_product_deleted' | 'crm_product_updated' | 'crm_proposal_created' | 'crm_source_created' | 'crm_source_deleted' | 'crm_source_updated' | 'crm_task_created' | 'crm_task_deleted' | 'crm_task_updated' — Nome do evento do webhook.
    - `http_method` 'POST' — Método HTTP do webhook.
    - `url` string, url — URL do webhook.
    - `status` 'active' | 'suspended' | 'inactive' — Status do webhook.
    - `auth_header` string — Nome do header de autenticação do webhook.
    - `auth_key` string — Chave de autenticação do webhook.
    - `created_at` string, date-time — Data de criação do webhook
    - `updated_at` string, date-time — Data de atualização do webhook.

## Other responses

- `400` — A requisição está malformada e não consegue ser processada.
- `401` — O token da API está ausente ou inválido.
- `403` — O token não tem permissão para acessar o recurso solicitado.
- `422` — A entidade não pode ser processada.
- `429` — O limite de requisições foi excedido.
- `500` — Internal Server Error

---

[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)