---
title: "Get dynamic webhooks for app"
method: GET
path: "/rest/api/3/webhook"
tags: ["Webhooks"]
---

# Get dynamic webhooks for app

`GET /rest/api/3/webhook`

Returns a [paginated](#pagination) list of the webhooks registered by the calling app.

**[Permissions](#permissions) required:** Only [Connect](https://developer.atlassian.com/cloud/jira/platform/#connect-apps) and [OAuth 2.0](https://developer.atlassian.com/cloud/jira/platform/oauth-2-3lo-apps) apps can use this operation.

## Query parameters

- `startAt` integer
- `maxResults` integer

## Response `200`

Returned if the request is successful.

- PageBeanWebhook — A page of items.
  - `isLast` boolean — Whether this is the last page.
  - `maxResults` integer — The maximum number of items that could be returned.
  - `nextPage` string, uri — If there is another page of results, the URL of the next page.
  - `self` string, uri — The URL of the page.
  - `startAt` integer — The index of the first item returned.
  - `total` integer — The number of items returned.
  - `values` Webhook[] — The list of items.
    - `events` string[], required — The Jira events that trigger the webhook.
    - `expirationDate` integer — The date after which the webhook is no longer sent. Use [Extend webhook life](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-webhooks/#api-rest-api-3-webhook-refresh-put) to extend the date.
    - `fieldIdsFilter` string[] — A list of field IDs. When the issue changelog contains any of the fields, the webhook `jira:issue_updated` is sent. If this parameter is not present, the app is notified about all field updates.
    - `id` integer, required — The ID of the webhook.
    - `issuePropertyKeysFilter` string[] — A list of issue property keys. A change of those issue properties triggers the `issue_property_set` or `issue_property_deleted` webhooks. If this parameter is not present, the app is notified about all issue property updates.
    - `jqlFilter` string, required — The JQL filter that specifies which issues the webhook is sent for.
    - `url` string, required — The URL that specifies where the webhooks are sent.

## Other responses

- `400` — Returned if the request is invalid.
- `403` — Returned if the caller isn't an app.

---

[API](https://skmtc.net/atlassian/apis/the-jira-cloud-platform-rest-api-2.md) · [All operations](https://skmtc.net/atlassian/apis/the-jira-cloud-platform-rest-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlassian/the-jira-cloud-platform-rest-api-2/versions/5a51740d7ab3/schema)