---
title: "Updating webhook configurations"
method: PUT
path: "/webhooks/{webhookId}"
tags: ["Webhook Configurations"]
---

# Updating webhook configurations

`PUT /webhooks/{webhookId}`

Updates a webhook configuration.

## Path parameters

- `webhookId` string, required

## Request body

- WebhookPostRequest
  - `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 — Url to be called when webhook is fired
  - `clientHeaders` object — Headers to be included on the request ({ "myCustomHeader": "myExpectedValue "})

## Response `200`

A confirmation of successful update of the webhook configuration

- Webhook — Webhook
  - `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 "})

## 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)