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

# Get failed webhooks

`GET /rest/api/3/webhook/failed`

Returns webhooks that have recently failed to be delivered to the requesting app after the maximum number of retries.

After 72 hours the failure may no longer be returned by this operation.

The oldest failure is returned first.

This method uses a cursor-based pagination. To request the next page use the failure time of the last webhook on the list as the `failedAfter` value or use the URL provided in `next`.

**[Permissions](#permissions) required:** Only [Connect apps](https://developer.atlassian.com/cloud/jira/platform/index/#connect-apps) can use this operation.

## Query parameters

- `maxResults` integer
- `after` integer

## Response `200`

Returned if the request is successful.

- FailedWebhooks — A page of failed webhooks.
  - `maxResults` integer, required — The maximum number of items on the page. If the list of values is shorter than this number, then there are no more pages.
  - `next` string, uri — The URL to the next page of results. Present only if the request returned at least one result.The next page may be empty at the time of receiving the response, but new failed webhooks may appear in time. You can save the URL to the next page and query for new results periodically (for example, every hour).
  - `values` FailedWebhook[], required — The list of webhooks.
    - `body` string — The webhook body.
    - `failureTime` integer, required — The time the webhook was added to the list of failed webhooks (that is, the time of the last failed retry).
    - `id` string, required — The webhook ID, as sent in the `X-Atlassian-Webhook-Identifier` header with the webhook.
    - `url` string, required — The original webhook destination.

## Other responses

- `400` — 400 response
- `403` — Returned if the caller is not a Connect 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)