---
title: "Listing webhook configurations"
method: GET
path: "/webhooks"
tags: ["Webhook Configurations"]
---

# Listing webhook configurations

`GET /webhooks`

Returns a list of webhooks.

## Query parameters

- `fields` string
- `perPage` integer
- `page` integer

## Response `200`

An array of webhooks

- PaginatedWebhook — An array of webhooks
  - `results` Webhook[], required
    - `id` string, required — Webhook ID
    - `action` 'application.created' | 'application.completed' | 'application.moved' | 'application.assigned' | 'candidate.hired' | 'job.changed' | 'job.new-recommendation' | 'job.published' | 'job.status-changed' | 'pre-employee.moved' | 'pre-employee.admission-concluded' | 'admission.automatic-routing-process' | 'admission.automatic-routing-objection' | 'admission.automatic-routing-confirmation' | 'application.evaluation' | 'job-offer.created' | 'job-offer.status-changed', required — Webhook action to watch
    - `status` 'active' | 'inactive' — Subscription status (defaults to active).
    - `techOwnerName` string — Technical responsible for the subscription
    - `techOwnerEmail` string — Email of the technical responsible
    - `postbackUrl` string, required — Url to be called when webhook is fired
    - `clientHeaders` object — Headers to be included on the request ({ "myCustomHeader": "myExpectedValue "})
  - `totalResults` integer
  - `page` integer
  - `totalPages` integer

## Other responses

- `400` — BadRequest / Invalid Input
- `401` — Unauthorized
- `403` — Forbidden

---

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