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

# Create a webhook

`POST /webhooks`

## Request

- Base URL: `https://api.intellihr.io`
- URL: `https://api.intellihr.io/webhooks`
- Auth: API key in header `Authorization`

## Request body

- WebhooksCreate
  - `url` string, required: The webhook endpoint which the request will be sent to when the subscribed event is triggered
  - `webhookEvent` string, required: The name of the [Webhook Event](#tag/Webhook-Events) e.g. `person.created`, `training.deleted`
  - `isEnabled` boolean: Denotes if this webhook is enabled
  - `source` string: A string specifying the source of creation for this webhook

## Response `201`

Created Successfully

- Webhooks
  - `data` object
    - `id` ResourceId (unresolved $ref)
    - `attributes` object
      - `url` string: The webhook endpoint which the request will be sent to when the subscribed event is triggered.
      - `webhookEventId` ResourceId (unresolved $ref)
      - `isEnabled` boolean: Specifies if this webhook is enabled
      - `source` string: A string specifying the source of creation for this webhook
      - `createdAt` RfcDateTime (unresolved $ref)
      - `updatedAt` RfcDateTime (unresolved $ref)

## Other responses

- `400` (unresolved $ref)
- `403` (unresolved $ref)
- `500` (unresolved $ref)

---

[API](https://skmtc.dev/intellihr/apis/intellihr-public-api.md) · [All operations](https://skmtc.dev/intellihr/apis/intellihr-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/intellihr/apis/intellihr-public-api/revisions/6529279c999b?raw)