---
title: "Register a Jira dynamic webhook (admin only)"
method: POST
path: "/api/trackers/jira/webhook-register"
tags: ["Trackers"]
---

# Register a Jira dynamic webhook (admin only)

`POST /api/trackers/jira/webhook-register`

## Request body

- object
  - `jqlFilter` string, required

## Response `200`

Webhook registered

- object
  - `webhookId` integer, required
  - `expiresAt` string, required
  - `jql` string, required

## Other responses

- `400` — Invalid jqlFilter
- `503` — Jira not connected or JIRA_WEBHOOK_TOKEN missing

## Changes

- **2026-08-07** `06cac6a7c5bc` — 3 info
  - added the media type `application/json` for the response with the status `200`
  - added the media type `application/json` for the response with the status `400`
  - added the media type `application/json` for the response with the status `503`

[Change history](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/changes/api/trackers/jira/webhook-register/post.md)

---

[API](https://skmtc.dev/desplega-ai/apis/agent-swarm-api.md) · [All operations](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/revisions/4d23bb3d853c?raw)