---
title: "Add a new webhook"
method: POST
path: "/webhooks"
tags: ["Webhook API:Webhooks"]
---

# Add a new webhook

`POST /webhooks`

## Request body

- AddWebhookCommand
  - `name` string, nullable, required
  - `events` EventName[], nullable, required
  - `eventFilters` SubmitWebhookEventFilterModel
    - `jobapplication_status_changed` SubmitWebhookEventStatusChangeFilterModel
      - `statusId` integer[], nullable — Limit events to a specific status
      - `statusActive` boolean — Limit events to an active/open status
  - `url` string, uri, nullable, required — Target URL that will listen for incoming HTTP POST notification messages.
  - `authorization` string, nullable — Optional authorization header to include with the HTTP POST notification.
  - `status` 'Enabled' | 'Disabled' | 'Suspended', string

## Response `201`

Created

- WebhookRepresentation
  - `webhookId` string, uuid
  - `name` string, nullable
  - `status` 'Enabled' | 'Disabled' | 'Suspended' | 'Failed', string
  - `url` string, uri, nullable
  - `events` EventName[], nullable
  - `eventFilters` WebhookEventFilterModel
    - `jobapplication_status_changed` WebhookEventStatusChangeFilterModel
      - `statusId` integer[], nullable — Limit events to a specific status
      - `statusActive` boolean — Limit events to an active/open status
  - `createdAt` string, date-time
  - `updatedAt` string, date-time
  - `enabledAt` string, date-time, nullable
  - `disabledAt` string, date-time, nullable
  - `suspendedAt` string, date-time, nullable
  - `failedAt` string, date-time, nullable
  - `links` ModelLinks
    - `self` string, uri, nullable

## Other responses

- `422` — Validation error

---

[API](https://skmtc.net/jobadder/apis/jobadder-api.md) · [All operations](https://skmtc.net/jobadder/apis/jobadder-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jobadder/jobadder-api/revisions/9f43f6a6ee6e/schema)