---
title: "Update a webhook"
method: PUT
path: "/webhook/{webhook_slug}"
tags: ["Webhook"]
---

# Update a webhook

`PUT /webhook/{webhook_slug}`

Updates the webhook identified by the specified slug.

## Path parameters

- `webhook_slug` string, required

## Headers

- `Accept` 'application/vnd.Creative Force.v2.3+json' | 'application/vnd.Creative Force.v2.3+xml', required

## Request body

- object
  - `method` 'get' | 'post' — HTTP method used to call the webhook URL.
  - `name` string — Name of the webhook.
  - `url` string, uri — URL that receives the webhook payload.
  - `signing_key` string — Key used to sign outgoing webhook requests so the receiver can validate the payload.
  - `events` string[] — Subscription events that trigger this webhook. For example, `["role_granted", "allocation_created"]`.

## Response `200`

Webhook updated.

- Webhook
  - `events` string[] — Subscription events that trigger this webhook.
  - `method` 'get' | 'post' — HTTP method used to call the webhook URL.
  - `name` string — Name of the webhook.
  - `slug` string — Slug of the webhook.
  - `signing_key` string — Key used to sign outgoing webhook requests so the receiver can validate the payload.
  - `url` string, uri — URL that receives the webhook payload.
  - `updated` string, date-time — Date and time the webhook was last updated.

---

[API](https://skmtc.dev/tectonic/apis/award-force-api.md) · [All operations](https://skmtc.dev/tectonic/apis/award-force-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tectonic/award-force-api/revisions/b70a2ea056c3/schema)