---
title: "Create Webhook"
method: POST
path: "/webhook"
tags: ["Webhook"]
---

# Create Webhook

`POST /webhook`

Create a new webhook

## Query parameters

- `select` string

## Request body

- Webhook
  - `id` string, uuid — Webhook ID
  - `created_at` string, timestamp with time zone — Webhook creation date
  - `updated_at` string, timestamp with time zone — Latest update
  - `organisation_id` string, uuid — Organisation ID
  - `name` string, text — Name of webhook
  - `source` 'zapier' | 'n8n' | 'make' | 'authenticated', public.webhook_source — Source of webhook
  - `active` boolean — Is the webhook active?
  - `target_url` string, text — Target url of webhook
  - `headers` object — Header of webhook
  - `method` 'GET' | 'POST' | 'PUT' | 'PATCH', public.http_method — Webhook method
  - `event` 'contact.created' | 'contact_details.updated' | 'contact.deleted' | 'conversation.inbound' | 'conversation.tag' | 'conversation.untag' | 'conversation.assign' | 'conversation.unassign' | 'conversation.submission_error' | 'conversation.sending_error' | 'conversation.outbound' | 'conversation.reopen' | 'conversation.close' | 'form_submission.completed' | 'form_submission.aborted' | 'contact.updated', public.webhook_event — Event of webhook

## Response `200`

The updated Webhook object

- Webhook
  - `id` string, uuid — Webhook ID
  - `created_at` string, timestamp with time zone — Webhook creation date
  - `updated_at` string, timestamp with time zone — Latest update
  - `organisation_id` string, uuid — Organisation ID
  - `name` string, text — Name of webhook
  - `source` 'zapier' | 'n8n' | 'make' | 'authenticated', public.webhook_source — Source of webhook
  - `active` boolean — Is the webhook active?
  - `target_url` string, text — Target url of webhook
  - `headers` object — Header of webhook
  - `method` 'GET' | 'POST' | 'PUT' | 'PATCH', public.http_method — Webhook method
  - `event` 'contact.created' | 'contact_details.updated' | 'contact.deleted' | 'conversation.inbound' | 'conversation.tag' | 'conversation.untag' | 'conversation.assign' | 'conversation.unassign' | 'conversation.submission_error' | 'conversation.sending_error' | 'conversation.outbound' | 'conversation.reopen' | 'conversation.close' | 'form_submission.completed' | 'form_submission.aborted' | 'contact.updated', public.webhook_event — Event of webhook

## Other responses

- `201` — The Webhook was created
- `204` — No Content

---

[API](https://skmtc.dev/getmateo/apis/mateo-api.md) · [All operations](https://skmtc.dev/getmateo/apis/mateo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getmateo/mateo-api/revisions/22a9b3b009d1/schema)