---
title: "Update a webhook (URL or active state)"
method: PATCH
path: "/webhooks/{id}"
tags: ["Webhooks"]
---

# Update a webhook (URL or active state)

`PATCH /webhooks/{id}`

## Request

- Base URL: `https://post.adaptlypost.com/post/api/v1`
- URL: `https://post.adaptlypost.com/post/api/v1/webhooks/{id}`
- Auth: HTTP bearer

Requires the `webhooks.manage` permission.

## Path parameters

- `id` string, required

## Headers

- `X-Workspace-Id` string

## Request body

- UpdateWebhookRequest
  - `url` string, uri
  - `active` boolean

## Response `200`

Updated webhook

- Webhook
  - `id` string
  - `url` string
  - `active` boolean
  - `createdAt` string, date-time
  - `updatedAt` string, date-time
  - `lastSuccessAt` string, date-time, nullable
  - `lastFailureAt` string, date-time, nullable
  - `disabledAt` string, date-time, nullable

## Other responses

- `400`: Invalid URL
- `401`: Invalid or missing API key
- `403`: The key's role does not hold `webhooks.manage`
- `404`: Webhook not found
- `409`: A webhook with this URL already exists
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/adaptlypost/apis/adaptlypost-public-api.md) · [All operations](https://skmtc.dev/adaptlypost/apis/adaptlypost-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/adaptlypost/apis/adaptlypost-public-api/revisions/8390a5fa9a0d?raw)