---
title: "Create a webhook"
method: POST
path: "/api/v1/webhooks/"
tags: ["Webhooks"]
---

# Create a webhook

`POST /api/v1/webhooks/`

## Request

- Base URL: `https://api.tuteliq.ai`
- URL: `https://api.tuteliq.ai/api/v1/webhooks/`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

Create a new webhook endpoint for receiving notifications

## Request body

- object
  - `name` string, required
  - `url` string, uri, required
  - `events` string[], required
  - `headers` object

## Response `201`

Default Response

- object
  - `id` string
  - `name` string
  - `url` string
  - `secret` string
  - `events` string[]
  - `is_active` boolean
  - `created_at` string

---

[API](https://skmtc.dev/tuteliq/apis/tuteliq-api.md) · [All operations](https://skmtc.dev/tuteliq/apis/tuteliq-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tuteliq/apis/tuteliq-api/revisions/8490332e0031?raw)