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

# Create Webhook

`POST /webhooks/`

## Request

- Base URL: `manahook.api.manatal.com/v1` (relative, and the document’s source URL is not known)
- URL: `manahook.api.manatal.com/v1/webhooks/`
- Auth: API key in header `Authorization`

Register a new webhook

## Request body

- WebhookRegister: Schema for receiving creating webhook request
  - `model` 'candidate' | 'contact' | 'match' | 'job', required: An enumeration.
  - `action` 'create' | 'update' | 'moved' | 'status_update', required: An enumeration. When model is match, allowed values are create and moved. When model is candidate or contact, allowed values are create and update. When model is job, allowed value is status_update.
  - `target_url` string, uri, required

## Response `201`

Successful Response

- WebhookReturn: Schema for returning only id
  - `id` integer, required

## Other responses

- `404`: Not Found
- `422`: Unprocessable Entity

---

[API](https://skmtc.dev/manatal/apis/manahook.md) - [All operations](https://skmtc.dev/manatal/apis/manahook/llms.txt) - [OpenAPI document](https://skmtc.dev/manatal/apis/manahook/revisions/7c29622da283?raw)